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

Author: gcf-owl-bot[bot]

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();
  }