Live Streaming Parameters

2022-06-23
No Rating

Description of Variables

Before reading the protocol, you can get familiar with the variables. In the process of reading the protocol, you can return this page for reference.

Variable NameDescriptionRemark
device_listIndicate the list of aircraft (or other devices), which contains the camera.
available_video_numberThe total number of video streams available for live streaming. Indicates the total number of all available live video streams owned by the aircraft or devices.
coexist_video_number_maxThe maximum total number of video streams that can be live streaming at the same time.
camera_listIndicates the list of cameras owned by aircraft, which contains the video.
camera_typeCamera model
camera_idThe id number of the camera is composed of the model name of the camera and the position number of the camera on the aircraft. This number is unique in an aircraft (or device).
video_listIndicates the list of video streams owned by camera.
video_typeIndicate the type of video stream. Such as H20T camera, there are several types of wide, zoom, ir and normal. Regarding the difference between normal and others: normal means that the video stream content of the channel will change. For example, when the APP adjusts the screen content at the front end, the H20T live screen content will change. Wide, zoom, and ir indicate that the channel is used to transmit the screen of the specified content. Unless the channel is switched, the screen content in the channel is fixed and will not be affected by APP adjustments.
video_indexIndicates the index and number of the video stream, as shown by the type of the video stream and the number of the video stream inside the camera. Such as wide-0, in a camera domain, the number is unique.
video_idIt is used to uniquely specify the ID number of a video stream. The composition rule is #{uav_sn}/#{camera_id}/#{video_index}
Example:AFAFEFA34D/H20T-0/normal-1
video_qualityThe quality of the live streaming, referring to several levels of live streaming parameters, such as Auto, Smooth, HD, Ultra HD. Each level has preset values for bps, fps, and resolution attributes. If you choose Auto, it will automatically adjust among the Smooth, HD, and ultra HD.
video_param_modeIt is used to query or set the mode prompts which used in live streaming related information. Currently, there are only two types of default and advanced. Default means to set video_quality, and advanced means to set the bps, fps, and resolution (dpi) of the video in detail.
live_trendlineIndicates the usage status of live streaming bandwidth (or the trend of live streaming performance). Each live channel has three states: normal, overuse, and underuse. For example, overuse means that the bandwidth usage is overloaded, thereby judging that the network is congested. If it is underuse, it means that the bandwidth has not been fully utilized. The value range is [0,10]: 0-4 means overuse, the smaller the value, the greater the degree of overuse. 5 means the normal state. 6~10 means underuse, the larger the value, the more percentage of bandwidth is not fully utilized.Corresponds to the previous netlink_quality
live_timeLive streaming time. Indicates the time that the device has been running since the start of the live streaming.
url_typeThe url type that needs to be specified for the live streaming parameters. The type can be GB28181, RTMP, RTSP, Agora and other live protocols.
urlOn the basis of determining the URL type, url is used to specify the specific url parameters based on the url_type. For different url_types, there are some differences in url composition rules. For the URL parameters of Agora, in order to prevent special characters from being included in the token, the cloud uses URLEncoder to encode and send it, and the pull stream side needs to be parsed by URLDecoder before use.
fpsThe frame rate of the video stream.
bpsThe bit rate of the video stream.
dpiThe resolution of the video stream.