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帧