# 视频采集器
该接口用于构造一个视频采集器，用以打开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的取流地址。 摄像头名称可登录华为HiLens控制台，在"设备管理\>设备列表\>摄像头配置\>摄像头管理"查看。   - 如果输入整型0，则构造一个UVC摄像头视频采集器（需插入UVC摄像头）。  - 如果输入本地MP4视频文件路径，则构造一个MP4视频采集器。   |
  | width   | 否，需要和height同时使用 | 整型                                                                                                                                                                                         | 设置读取到的视频帧图片宽度（要求为16的倍数，推荐为32的倍数，且最小为128），仅支持IPC摄像头和MP4视频文件进行设置。 如果不输入参数，默认按视频帧原始宽高。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | height  | 否，需要和width同时使用  | 整型                                                                                                                                                                                         | 设置读取到的视频帧图片高度（要求为2的倍数，且最小为128），仅支持IPC摄像头和MP4视频文件进行设置。 如果不输入参数，默认按视频帧原始宽高。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
     
  

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