docs: updated comments to match API behaviors (#52)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 449874412

Source-Link: googleapis/googleapis@4c6f583

Source-Link: https://github.com/googleapis/googleapis-gen/commit/ead9c4d1cb0cabf095b446c9988a1855a2cbb1db
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWFkOWM0ZDFjYjBjYWJmMDk1YjQ0NmM5OTg4YTE4NTVhMmNiYjFkYiJ9

proto-google-cloud-live-stream-v1/src/main/java/com/google/cloud/video/livestream/v1/Channel.java

@@ -355,8 +355,7 @@ public enum StreamingState implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * <pre>
-     * Channel is waiting for the input stream through the input. Live streams
-     * do not start yet.
+     * Channel is waiting for the input stream through the input.
      * </pre>
      *
      * <code>AWAITING_INPUT = 2;</code>
@@ -380,6 +379,7 @@ public enum StreamingState implements com.google.protobuf.ProtocolMessageEnum {
      * <pre>
      * Channel is generating live streams with no input stream. Live streams are
      * filled out with black screen, while input stream is missing.
+     * Not supported yet.
      * </pre>
      *
      * <code>STREAMING_NO_INPUT = 5;</code>
@@ -443,8 +443,7 @@ public enum StreamingState implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * <pre>
-     * Channel is waiting for the input stream through the input. Live streams
-     * do not start yet.
+     * Channel is waiting for the input stream through the input.
      * </pre>
      *
      * <code>AWAITING_INPUT = 2;</code>
@@ -468,6 +467,7 @@ public enum StreamingState implements com.google.protobuf.ProtocolMessageEnum {
      * <pre>
      * Channel is generating live streams with no input stream. Live streams are
      * filled out with black screen, while input stream is missing.
+     * Not supported yet.
      * </pre>
      *
      * <code>STREAMING_NO_INPUT = 5;</code>

proto-google-cloud-live-stream-v1/src/main/java/com/google/cloud/video/livestream/v1/Event.java

@@ -300,6 +300,16 @@ public enum State implements com.google.protobuf.ProtocolMessageEnum {
      * <code>PENDING = 5;</code>
      */
     PENDING(5),
+    /**
+     *
+     *
+     * <pre>
+     * Event was stopped before running for its full duration.
+     * </pre>
+     *
+     * <code>STOPPED = 6;</code>
+     */
+    STOPPED(6),
     UNRECOGNIZED(-1),
     ;
 
@@ -363,6 +373,16 @@ public enum State implements com.google.protobuf.ProtocolMessageEnum {
      * <code>PENDING = 5;</code>
      */
     public static final int PENDING_VALUE = 5;
+    /**
+     *
+     *
+     * <pre>
+     * Event was stopped before running for its full duration.
+     * </pre>
+     *
+     * <code>STOPPED = 6;</code>
+     */
+    public static final int STOPPED_VALUE = 6;
 
     public final int getNumber() {
       if (this == UNRECOGNIZED) {
@@ -400,6 +420,8 @@ public static State forNumber(int value) {
           return FAILED;
         case 5:
           return PENDING;
+        case 6:
+          return STOPPED;
         default:
           return null;
       }

proto-google-cloud-live-stream-v1/src/main/java/com/google/cloud/video/livestream/v1/Manifest.java

@@ -494,7 +494,7 @@ public com.google.protobuf.ByteString getMuxStreamsBytes(int index) {
    * Maximum number of segments that this manifest holds. Once the manifest
    * reaches this maximum number of segments, whenever a new segment is added to
    * the manifest, the oldest segment will be removed from the manifest.
-   * The minimum value is 1 and the default value is 5.
+   * The minimum value is 3 and the default value is 5.
    * </pre>
    *
    * <code>int32 max_segment_count = 4;</code>
@@ -1414,7 +1414,7 @@ public Builder addMuxStreamsBytes(com.google.protobuf.ByteString value) {
      * Maximum number of segments that this manifest holds. Once the manifest
      * reaches this maximum number of segments, whenever a new segment is added to
      * the manifest, the oldest segment will be removed from the manifest.
-     * The minimum value is 1 and the default value is 5.
+     * The minimum value is 3 and the default value is 5.
      * </pre>
      *
      * <code>int32 max_segment_count = 4;</code>
@@ -1432,7 +1432,7 @@ public int getMaxSegmentCount() {
      * Maximum number of segments that this manifest holds. Once the manifest
      * reaches this maximum number of segments, whenever a new segment is added to
      * the manifest, the oldest segment will be removed from the manifest.
-     * The minimum value is 1 and the default value is 5.
+     * The minimum value is 3 and the default value is 5.
      * </pre>
      *
      * <code>int32 max_segment_count = 4;</code>
@@ -1453,7 +1453,7 @@ public Builder setMaxSegmentCount(int value) {
      * Maximum number of segments that this manifest holds. Once the manifest
      * reaches this maximum number of segments, whenever a new segment is added to
      * the manifest, the oldest segment will be removed from the manifest.
-     * The minimum value is 1 and the default value is 5.
+     * The minimum value is 3 and the default value is 5.
      * </pre>
      *
      * <code>int32 max_segment_count = 4;</code>

proto-google-cloud-live-stream-v1/src/main/java/com/google/cloud/video/livestream/v1/ManifestOrBuilder.java

@@ -155,7 +155,7 @@ public interface ManifestOrBuilder
    * Maximum number of segments that this manifest holds. Once the manifest
    * reaches this maximum number of segments, whenever a new segment is added to
    * the manifest, the oldest segment will be removed from the manifest.
-   * The minimum value is 1 and the default value is 5.
+   * The minimum value is 3 and the default value is 5.
    * </pre>
    *
    * <code>int32 max_segment_count = 4;</code>

proto-google-cloud-live-stream-v1/src/main/java/com/google/cloud/video/livestream/v1/OutputsProto.java

@@ -90,78 +90,76 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     java.lang.String[] descriptorData = {
       "\n.google/cloud/video/livestream/v1/outpu"
           + "ts.proto\022 google.cloud.video.livestream."
-          + "v1\032\034google/api/annotations.proto\032\037google"
-          + "/api/field_behavior.proto\032\036google/protob"
-          + "uf/duration.proto\"\207\002\n\020ElementaryStream\022\013"
-          + "\n\003key\030\004 \001(\t\022E\n\014video_stream\030\001 \001(\0132-.goog"
-          + "le.cloud.video.livestream.v1.VideoStream"
-          + "H\000\022E\n\014audio_stream\030\002 \001(\0132-.google.cloud."
-          + "video.livestream.v1.AudioStreamH\000\022C\n\013tex"
-          + "t_stream\030\003 \001(\0132,.google.cloud.video.live"
-          + "stream.v1.TextStreamH\000B\023\n\021elementary_str"
-          + "eam\"\224\001\n\tMuxStream\022\013\n\003key\030\001 \001(\t\022\021\n\tcontai"
-          + "ner\030\003 \001(\t\022\032\n\022elementary_streams\030\004 \003(\t\022K\n"
-          + "\020segment_settings\030\005 \001(\01321.google.cloud.v"
-          + "ideo.livestream.v1.SegmentSettings\"\232\002\n\010M"
-          + "anifest\022\021\n\tfile_name\030\001 \001(\t\022J\n\004type\030\002 \001(\016"
-          + "27.google.cloud.video.livestream.v1.Mani"
-          + "fest.ManifestTypeB\003\340A\002\022\030\n\013mux_streams\030\003 "
-          + "\003(\tB\003\340A\002\022\031\n\021max_segment_count\030\004 \001(\005\0228\n\025s"
-          + "egment_keep_duration\030\005 \001(\0132\031.google.prot"
-          + "obuf.Duration\"@\n\014ManifestType\022\035\n\031MANIFES"
-          + "T_TYPE_UNSPECIFIED\020\000\022\007\n\003HLS\020\001\022\010\n\004DASH\020\002\""
-          + "\343\001\n\013SpriteSheet\022\016\n\006format\030\001 \001(\t\022\030\n\013file_"
-          + "prefix\030\002 \001(\tB\003\340A\002\022 \n\023sprite_width_pixels"
-          + "\030\003 \001(\005B\003\340A\002\022!\n\024sprite_height_pixels\030\004 \001("
-          + "\005B\003\340A\002\022\024\n\014column_count\030\005 \001(\005\022\021\n\trow_coun"
-          + "t\030\006 \001(\005\022+\n\010interval\030\007 \001(\0132\031.google.proto"
-          + "buf.Duration\022\017\n\007quality\030\010 \001(\005\"\342\002\n\023Prepro"
-          + "cessingConfig\022H\n\004crop\030\002 \001(\0132:.google.clo"
-          + "ud.video.livestream.v1.PreprocessingConf"
-          + "ig.Crop\022F\n\003pad\030\003 \001(\01329.google.cloud.vide"
-          + "o.livestream.v1.PreprocessingConfig.Pad\032"
-          + "\\\n\004Crop\022\022\n\ntop_pixels\030\001 \001(\005\022\025\n\rbottom_pi"
-          + "xels\030\002 \001(\005\022\023\n\013left_pixels\030\003 \001(\005\022\024\n\014right"
-          + "_pixels\030\004 \001(\005\032[\n\003Pad\022\022\n\ntop_pixels\030\001 \001(\005"
-          + "\022\025\n\rbottom_pixels\030\002 \001(\005\022\023\n\013left_pixels\030\003"
-          + " \001(\005\022\024\n\014right_pixels\030\004 \001(\005\"\377\003\n\013VideoStre"
-          + "am\022O\n\004h264\030\024 \001(\0132?.google.cloud.video.li"
-          + "vestream.v1.VideoStream.H264CodecSetting"
-          + "sH\000\032\214\003\n\021H264CodecSettings\022\024\n\014width_pixel"
-          + "s\030\001 \001(\005\022\025\n\rheight_pixels\030\002 \001(\005\022\027\n\nframe_"
-          + "rate\030\003 \001(\001B\003\340A\002\022\030\n\013bitrate_bps\030\004 \001(\005B\003\340A"
-          + "\002\022\026\n\016allow_open_gop\030\006 \001(\010\022\031\n\017gop_frame_c"
-          + "ount\030\007 \001(\005H\000\0221\n\014gop_duration\030\010 \001(\0132\031.goo"
-          + "gle.protobuf.DurationH\000\022\025\n\rvbv_size_bits"
-          + "\030\t \001(\005\022\031\n\021vbv_fullness_bits\030\n \001(\005\022\025\n\rent"
-          + "ropy_coder\030\013 \001(\t\022\021\n\tb_pyramid\030\014 \001(\010\022\025\n\rb"
-          + "_frame_count\030\r \001(\005\022\023\n\013aq_strength\030\016 \001(\001\022"
-          + "\017\n\007profile\030\017 \001(\t\022\014\n\004tune\030\020 \001(\tB\n\n\010gop_mo"
-          + "deB\020\n\016codec_settings\"\332\002\n\013AudioStream\022\020\n\010"
-          + "transmux\030\010 \001(\010\022\r\n\005codec\030\001 \001(\t\022\030\n\013bitrate"
-          + "_bps\030\002 \001(\005B\003\340A\002\022\025\n\rchannel_count\030\003 \001(\005\022\026"
-          + "\n\016channel_layout\030\004 \003(\t\022K\n\007mapping\030\005 \003(\0132"
-          + ":.google.cloud.video.livestream.v1.Audio"
-          + "Stream.AudioMapping\022\031\n\021sample_rate_hertz"
-          + "\030\006 \001(\005\032y\n\014AudioMapping\022\026\n\tinput_key\030\006 \001("
-          + "\tB\003\340A\002\022\030\n\013input_track\030\002 \001(\005B\003\340A\002\022\032\n\rinpu"
-          + "t_channel\030\003 \001(\005B\003\340A\002\022\033\n\016output_channel\030\004"
-          + " \001(\005B\003\340A\002\" \n\nTextStream\022\022\n\005codec\030\001 \001(\tB\003"
-          + "\340A\002\"F\n\017SegmentSettings\0223\n\020segment_durati"
-          + "on\030\001 \001(\0132\031.google.protobuf.DurationB\357\001\n$"
-          + "com.google.cloud.video.livestream.v1B\014Ou"
-          + "tputsProtoP\001ZJgoogle.golang.org/genproto"
-          + "/googleapis/cloud/video/livestream/v1;li"
-          + "vestream\252\002 Google.Cloud.Video.LiveStream"
-          + ".V1\312\002 Google\\Cloud\\Video\\LiveStream\\V1\352\002"
-          + "$Google::Cloud::Video::LiveStream::V1b\006p"
-          + "roto3"
+          + "v1\032\037google/api/field_behavior.proto\032\036goo"
+          + "gle/protobuf/duration.proto\"\207\002\n\020Elementa"
+          + "ryStream\022\013\n\003key\030\004 \001(\t\022E\n\014video_stream\030\001 "
+          + "\001(\0132-.google.cloud.video.livestream.v1.V"
+          + "ideoStreamH\000\022E\n\014audio_stream\030\002 \001(\0132-.goo"
+          + "gle.cloud.video.livestream.v1.AudioStrea"
+          + "mH\000\022C\n\013text_stream\030\003 \001(\0132,.google.cloud."
+          + "video.livestream.v1.TextStreamH\000B\023\n\021elem"
+          + "entary_stream\"\224\001\n\tMuxStream\022\013\n\003key\030\001 \001(\t"
+          + "\022\021\n\tcontainer\030\003 \001(\t\022\032\n\022elementary_stream"
+          + "s\030\004 \003(\t\022K\n\020segment_settings\030\005 \001(\01321.goog"
+          + "le.cloud.video.livestream.v1.SegmentSett"
+          + "ings\"\232\002\n\010Manifest\022\021\n\tfile_name\030\001 \001(\t\022J\n\004"
+          + "type\030\002 \001(\01627.google.cloud.video.livestre"
+          + "am.v1.Manifest.ManifestTypeB\003\340A\002\022\030\n\013mux_"
+          + "streams\030\003 \003(\tB\003\340A\002\022\031\n\021max_segment_count\030"
+          + "\004 \001(\005\0228\n\025segment_keep_duration\030\005 \001(\0132\031.g"
+          + "oogle.protobuf.Duration\"@\n\014ManifestType\022"
+          + "\035\n\031MANIFEST_TYPE_UNSPECIFIED\020\000\022\007\n\003HLS\020\001\022"
+          + "\010\n\004DASH\020\002\"\343\001\n\013SpriteSheet\022\016\n\006format\030\001 \001("
+          + "\t\022\030\n\013file_prefix\030\002 \001(\tB\003\340A\002\022 \n\023sprite_wi"
+          + "dth_pixels\030\003 \001(\005B\003\340A\002\022!\n\024sprite_height_p"
+          + "ixels\030\004 \001(\005B\003\340A\002\022\024\n\014column_count\030\005 \001(\005\022\021"
+          + "\n\trow_count\030\006 \001(\005\022+\n\010interval\030\007 \001(\0132\031.go"
+          + "ogle.protobuf.Duration\022\017\n\007quality\030\010 \001(\005\""
+          + "\342\002\n\023PreprocessingConfig\022H\n\004crop\030\002 \001(\0132:."
+          + "google.cloud.video.livestream.v1.Preproc"
+          + "essingConfig.Crop\022F\n\003pad\030\003 \001(\01329.google."
+          + "cloud.video.livestream.v1.PreprocessingC"
+          + "onfig.Pad\032\\\n\004Crop\022\022\n\ntop_pixels\030\001 \001(\005\022\025\n"
+          + "\rbottom_pixels\030\002 \001(\005\022\023\n\013left_pixels\030\003 \001("
+          + "\005\022\024\n\014right_pixels\030\004 \001(\005\032[\n\003Pad\022\022\n\ntop_pi"
+          + "xels\030\001 \001(\005\022\025\n\rbottom_pixels\030\002 \001(\005\022\023\n\013lef"
+          + "t_pixels\030\003 \001(\005\022\024\n\014right_pixels\030\004 \001(\005\"\377\003\n"
+          + "\013VideoStream\022O\n\004h264\030\024 \001(\0132?.google.clou"
+          + "d.video.livestream.v1.VideoStream.H264Co"
+          + "decSettingsH\000\032\214\003\n\021H264CodecSettings\022\024\n\014w"
+          + "idth_pixels\030\001 \001(\005\022\025\n\rheight_pixels\030\002 \001(\005"
+          + "\022\027\n\nframe_rate\030\003 \001(\001B\003\340A\002\022\030\n\013bitrate_bps"
+          + "\030\004 \001(\005B\003\340A\002\022\026\n\016allow_open_gop\030\006 \001(\010\022\031\n\017g"
+          + "op_frame_count\030\007 \001(\005H\000\0221\n\014gop_duration\030\010"
+          + " \001(\0132\031.google.protobuf.DurationH\000\022\025\n\rvbv"
+          + "_size_bits\030\t \001(\005\022\031\n\021vbv_fullness_bits\030\n "
+          + "\001(\005\022\025\n\rentropy_coder\030\013 \001(\t\022\021\n\tb_pyramid\030"
+          + "\014 \001(\010\022\025\n\rb_frame_count\030\r \001(\005\022\023\n\013aq_stren"
+          + "gth\030\016 \001(\001\022\017\n\007profile\030\017 \001(\t\022\014\n\004tune\030\020 \001(\t"
+          + "B\n\n\010gop_modeB\020\n\016codec_settings\"\332\002\n\013Audio"
+          + "Stream\022\020\n\010transmux\030\010 \001(\010\022\r\n\005codec\030\001 \001(\t\022"
+          + "\030\n\013bitrate_bps\030\002 \001(\005B\003\340A\002\022\025\n\rchannel_cou"
+          + "nt\030\003 \001(\005\022\026\n\016channel_layout\030\004 \003(\t\022K\n\007mapp"
+          + "ing\030\005 \003(\0132:.google.cloud.video.livestrea"
+          + "m.v1.AudioStream.AudioMapping\022\031\n\021sample_"
+          + "rate_hertz\030\006 \001(\005\032y\n\014AudioMapping\022\026\n\tinpu"
+          + "t_key\030\006 \001(\tB\003\340A\002\022\030\n\013input_track\030\002 \001(\005B\003\340"
+          + "A\002\022\032\n\rinput_channel\030\003 \001(\005B\003\340A\002\022\033\n\016output"
+          + "_channel\030\004 \001(\005B\003\340A\002\" \n\nTextStream\022\022\n\005cod"
+          + "ec\030\001 \001(\tB\003\340A\002\"F\n\017SegmentSettings\0223\n\020segm"
+          + "ent_duration\030\001 \001(\0132\031.google.protobuf.Dur"
+          + "ationB\357\001\n$com.google.cloud.video.livestr"
+          + "eam.v1B\014OutputsProtoP\001ZJgoogle.golang.or"
+          + "g/genproto/googleapis/cloud/video/livest"
+          + "ream/v1;livestream\252\002 Google.Cloud.Video."
+          + "LiveStream.V1\312\002 Google\\Cloud\\Video\\LiveS"
+          + "tream\\V1\352\002$Google::Cloud::Video::LiveStr"
+          + "eam::V1b\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
             descriptorData,
             new com.google.protobuf.Descriptors.FileDescriptor[] {
-              com.google.api.AnnotationsProto.getDescriptor(),
               com.google.api.FieldBehaviorProto.getDescriptor(),
               com.google.protobuf.DurationProto.getDescriptor(),
             });
@@ -310,7 +308,6 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     registry.add(com.google.api.FieldBehaviorProto.fieldBehavior);
     com.google.protobuf.Descriptors.FileDescriptor.internalUpdateFileDescriptor(
         descriptor, registry);
-    com.google.api.AnnotationsProto.getDescriptor();
     com.google.api.FieldBehaviorProto.getDescriptor();
     com.google.protobuf.DurationProto.getDescriptor();
   }