更新时间:2022-02-22 GMT+08:00

视频采集器

该接口用于构造一个视频采集器,用以打开HiLens Kit自带的摄像头、构造一个IPC摄像头视频采集器(目前支持RTSP协议的IPC)或构造一个UVC摄像头(符合USB视频类(USB Video Class)规范的摄像头设备)视频采集器。目前HiLens Kit有两个USB接口,但只能接入一个USB摄像头。

升级到1.0.7及以后的固件版本,本接口支持读取本地MP4文件,并支持设置通过IPC摄像头或者本地MP4文件读取到的视频帧图片宽度、高度。

  • 接口调用

    hilens.VideoCapture(camera)

    1.0.7及以后固件版本:

    hilens.VideoCapture(camera, width, height)

  • 参数说明
    表1 参数说明

    参数名

    是否必选

    参数类型

    描述

    camera

    • 字符串
    • 整型0
    • 如果不输入参数,则构造一个视频采集器以打开HiLens Kit自带的摄像头,一台设备只有一个技能可以使用自带摄像头,不然会资源抢占导致错误
    • 如果输入设备配置中的摄像头名称,则构造一个IPC摄像头视频采集器。此时优先输入设备配置中的摄像头名称,也可以直接传入形如rtsp://xxx的取流地址。

      摄像头名称可登录Huawei Hilens控制台,在“设备管理>设备列表>摄像头配置>摄像头管理”查看。

    • 如果输入整型0,则构造一个UVC摄像头视频采集器(需插入UVC摄像头)。
    • 如果输入本地MP4视频文件路径,则构造一个MP4视频采集器。

    width

    否,需要和height同时使用

    整型

    设置读取到的视频帧图片宽度(要求为16的倍数,推荐为32的倍 数,且最小为128),仅支持IPC摄像头和MP4视频文件进行设置。

    如果不输入参数,默认按视频帧原始宽高。

    height

    否,需要和width同时使用

    整型

    设置读取到的视频帧图片高度(要求为2的倍数,且最小为128),仅支持IPC摄像头和MP4视频文件进行设置。

    如果不输入参数,默认按视频帧原始宽高。

  • 返回值
    • 自带摄像头的视频采集器。
    • IPC视频采集器。
    • UVC摄像头视频采集器。
    • MP4视频采集器。
    • 如果创建失败则抛出一个CreateError。开发者可以在查看技能日志输出