Q:使用getSupportedCameras接口获取摄像头设备时,获得的后置摄像头有且仅有一个广角的,无法指定其他类型的后置摄像头。
另外,如何获取USB相机、分布式相机等外部相机?
可以通过CameraPosition(相机位置,前置/后置)和ConnectionType(连接方式,内置/USB连接/分布式摄像头)两个参数来筛选业务需要的相机设备,然后起流拍摄。
例如在自拍场景,可以选取CameraPosition为CameraPosition.CAMERA_POSITION_FRONT的相机设备初始化资源、起流拍摄。如果需要使用USB/分布式相机,则可以通过ConnectionType参数选取指定的相机设备。
对于内置相机来说,当前还不支持直接获取物理摄像头,只能获取逻辑摄像头。一台设备上可能存在多个内置物理摄像头,但是通过接口最多只能查询到两个逻辑摄像头,即前置和后置摄像头,无法显式指定具体使用哪颗后置摄像头。
以选择USB相机为例,在getSupportedCameras接口返回的设备列表中选择ConnectionType为CAMERA_CONNECTION_USB_PLUGIN的设备初始化相机资源,然后起流拍摄即可。后续的初始化资源、起流拍摄的过程与使用内置相机的流程完全一致,可参考:拍照实践(ArkTS)。
API23之后,如想使用分布式相机,需要通过getCameraDevices接口去查找相机设备,将接口入参connectType指定为ConnectionType.CAMERA_CONNECTION_REMOTE即可。后续初始化、起流拍摄的流程也与内置相机流程一致。
如果接口返回的设备列表中不存在CAMERA_CONNECTION_USB_PLUGIN/CAMERA_CONNECTION_REMOTE的设备,则说明当前设备不支持对应的外接USB相机或分布式相机设备。
目前getCameraDevice/getCameraDevices两个接口的type/types参数只能指定为CameraType.CAMERA_TYPE_DEFAULT,无法通过该参数定向查找广角/超广角/长焦/带景深信息的相机设备。
外接设备分为两种,即USB连接的相机(CAMERA_CONNECTION_USB_PLUGIN)和分布式相机(CAMERA_CONNECTION_REMOTE)。USB连接的相机可以通过cameraId字段拿到相机的商品传播名,分布式相机则可以通过hostDeviceName字段获取对应相机设备的传播名。
需要注意的是,分布式相机是指在同一个无线组网环境中的相机设备,可能是另一台手机或者平板设备。目前分布式相机的远端设备类型仅支持PHONE和TABLET,其他类型的远端设备(如AI眼镜等)即便能识别到其摄像头,也无法显式指定调用。另外,非分布式相机的hostDeviceName字段为空。
上述三个接口优缺点对比情况如下表:
接口 | 优点 | 缺点 | 推荐应用场景 |
|---|---|---|---|
可以查询所有非分布式相机设备 | 无法查询分布式相机;需从列表中手动筛选设备 | 所有不涉及分布式相机的场景 | |
可以根据参数查询特定相机设备 | 感知不到全部设备 | 仅适用于特定场景(如自拍场景,指定查询前置摄像头,查询不到直接退出) | |
可以根据参数查询特定相机设备列表;可查询到分布式相机 | 感知不到全部设备;需从列表中手动筛选设备 | 同getCameraDevice,尤其是分布式相机应用场景 |