Live Streaming Parameters
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 Name | Description | Remark |
---|---|---|
device_list | Indicate the list of aircraft (or other devices), which contains the camera. | |
available_video_number | The 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_max | The maximum total number of video streams that can be live streaming at the same time. | |
camera_list | Indicates the list of cameras owned by aircraft, which contains the video. | |
camera_type | Camera model | |
camera_id | The 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_list | Indicates the list of video streams owned by camera. | |
video_type | Indicate 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_index | Indicates 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_id | It 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_quality | The 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_mode | It 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_trendline | Indicates 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_time | Live streaming time. Indicates the time that the device has been running since the start of the live streaming. | |
url_type | The url type that needs to be specified for the live streaming parameters. The type can be GB28181, RTMP, RTSP, Agora and other live protocols. | |
url | On 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. | |
fps | The frame rate of the video stream. | |
bps | The bit rate of the video stream. | |
dpi | The resolution of the video stream. |