Video API, gRPC: StreamLineService.Get
Retrieves detailed information about a specific stream line by its ID.
Returns all stream line metadata, configuration, and related information.
gRPC request
rpc Get (GetStreamLineRequest) returns (StreamLine)
GetStreamLineRequest
{
"stream_line_id": "string"
}
|
Field |
Description |
|
stream_line_id |
string Required field. ID of the stream line to retrieve. The maximum string length in characters is 50. |
StreamLine
{
"id": "string",
"channel_id": "string",
"title": "string",
// Includes only one of the fields `rtmp_push`, `rtmp_pull`
"rtmp_push": {
"url": "string"
},
"rtmp_pull": {
"url": "string"
},
// end of the list of possible fields
// Includes only one of the fields `manual_line`, `auto_line`
"manual_line": "ManualLine",
"auto_line": {
"status": "AutoLineStatus"
},
// end of the list of possible fields
"created_at": "google.protobuf.Timestamp",
"updated_at": "google.protobuf.Timestamp",
"labels": "map<string, string>"
}
Entity representing the incoming video signal settings.
|
Field |
Description |
|
id |
string ID of the line. |
|
channel_id |
string ID of the channel to which this stream line belongs. |
|
title |
string Title of the stream line. |
|
rtmp_push |
Real-Time Messaging Protocol (RTMP) push input type. Includes only one of the fields Specifies the input type and settings for the video signal source. |
|
rtmp_pull |
Real-Time Messaging Protocol (RTMP) pull input type. Includes only one of the fields Specifies the input type and settings for the video signal source. |
|
manual_line |
Manual stream control. Includes only one of the fields Specifies the control type of the stream line. |
|
auto_line |
Automatic stream control. Includes only one of the fields Specifies the control type of the stream line. |
|
created_at |
Timestamp when the stream line was initially created in the system. |
|
updated_at |
Timestamp of the last modification to the stream line or its metadata. |
|
labels |
object (map<string, string>) Custom user-defined labels as |
RTMPPushInput
Settings for an RTMP (Real-Time Messaging Protocol) push input.
Used when the video stream is pushed to an RTMP server.
@see https://en.wikipedia.org/wiki/Real-Time_Messaging_Protocol
|
Field |
Description |
|
url |
string RTMP server url. |
RTMPPullInput
Settings for an RTMP pull input.
Used when the service pulls the video stream from an RTMP source.
@see https://en.wikipedia.org/wiki/Real-Time_Messaging_Protocol
|
Field |
Description |
|
url |
string RTMP url for receiving video signal. |
ManualLine
Represents a manual line type where the stream control is handled manually.
This means that stream start/stop actions are performed by the user.
|
Field |
Description |
|
Empty |
|
AutoLine
Represents an automatic line type where the stream control is handled automatically.
|
Field |
Description |
|
status |
enum AutoLineStatus The status of the automatic line.
|