5.18. sail.MultiDecoder
多路解码接口,支持同时解码多路视频。
5.18.1. __init__
- 接口形式:
def __init__(self, queue_size: int = 10, tpu_id: int = 0, discard_mode: int = 0)
参数说明:
queue_size: int
输入参数。每路视频,解码缓存图像队列的长度。
tpu_id: int
输入参数。使用的tpu id,默认为0。
discard_mode: int
输入参数。缓存达到最大值之后,数据的丢弃策略。0表示不在放数据进缓存;1表示先从队列中取出队列头的图片,丢弃之后再讲解码出来的图片缓存进去。默认为0。
5.18.2. set_read_timeout
设置读取图片的超时时间,对read和read_接口生效,超时之后仍然没有获取到图像,结果就会返回。
- 接口形式:
def set_read_timeout(self, timeout: int) -> None
参数说明:
timeout: int
输入参数。超时时间,单位是秒。
5.18.3. add_channel
添加一个通道。
- 接口形式:
def add_channel(self, file_path: str, frame_skip_num: int = 0) -> int
参数说明:
file_path: str
输入参数。视频的路径或者链接。
frame_skip_num: int
输入参数。解码缓存的主动丢帧数,默认是0,不主动丢帧。
返回值说明
返回视频对应的唯一的通道号。类型为整形。
5.18.4. del_channel
删除一个已经添加的视频通道。
- 接口形式:
def del_channel(self, channel_idx: int) -> int
参数说明:
channel_idx: int
输入参数。将要删除视频的通道号。
返回值说明
成功返回0,其他值时表示失败。
5.18.5. clear_queue
清除指定通道的图片缓存。
- 接口形式:
def clear_queue(self, channel_idx: int) -> int
参数说明:
channel_idx: int
输入参数。将要删除视频的通道号。
返回值说明:
成功返回0,其他值时表示失败。
5.18.6. read
从指定的视频通道中获取一张图片。
- 接口形式1:
def read(self, channel_idx: int, image: BMImage, read_mode: int = 0) -> int
参数说明1:
channel_idx: int
输入参数。指定的视频通道号。
image: BMImage
输出参数。解码出来的图片。
read_mode: int
输入参数。获取图片的模式,0表示不等待,直接从缓存中读取一张,无论有没有读取到都会返回。其他的表示等到获取到图片之后再返回。
返回值说明1:
成功返回0,其他值时表示失败。
- 接口形式2:
def read(self, channel_idx: int) -> BMImage
参数说明2:
channel_idx: int
输入参数。指定的视频通道号。
返回值说明2:
返回解码出来的图片,类型为BMImage。
5.18.7. read_
从指定的视频通道中获取一张图片,通常是要和BMImageArray一起使用。
- 接口形式1:
def read_(self, channel_idx: int, image: bm_image, read_mode: int=0) -> int
参数说明1:
channel_idx: int
输入参数。指定的视频通道号。
image: bm_image
输出参数。解码出来的图片。
read_mode: int
输入参数。获取图片的模式,0表示不等待,直接从缓存中读取一张,无论有没有读取到都会返回。其他的表示等到获取到图片之后再返回。
返回值说明1:
成功返回0,其他值时表示失败。
- 接口形式2:
def read_(self, channel_idx: int) -> int: """ Read a bm_image from the MultiDecoder with a given channel.
参数说明2:
channel_idx: int
输入参数。指定的视频通道号。
返回值说明2:
返回解码出来的图片,类型为bm_image。
5.18.8. reconnect
重连相应的通道的视频。
- 接口形式:
def reconnect(self, channel_idx: int) -> int
参数说明:
channel_idx: int
输入参数。输入图像的通道号。
返回值说明
成功返回0,其他值时表示失败。
5.18.9. get_frame_shape
获取相应通道的图像shape。
- 接口形式:
def get_frame_shape(self, channel_idx: int) -> list[int]
参数说明:
输入参数。输入图像的通道号。
返回值说明
返回一个由1,通道数,图像高度,图像宽度组成的list。
5.18.10. set_local_flag
设置视频是否为本地视频。如果不调用则表示为视频为网络视频流。
- 接口形式:
def set_local_flag(self, flag: bool) -> None:
参数说明:
flag: bool
标准位,如果为True,每路视频每秒固定解码25帧