OpenHarmony Camera开发指导(二):相机装备管理(ArkTS)
在开发一个相机应用前,需要先通过调用Camera接口获取支持的相机装备列表,然后创建相机装备对象做后续处置惩罚。开发步调
1、导入camera接口,接口中提供了相机相干的属性和方法,导入方法如下。
import { camera } from '@kit.CameraKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';
2、通过getCameraManager方法,获取相机管理器实例对象。
function getCameraManager(context: common.BaseContext): camera.CameraManager | undefined {
let cameraManager: camera.CameraManager | undefined = undefined;
try {
cameraManager = camera.getCameraManager(context);
} catch (error) {
let err = error as BusinessError;
console.error(`The getCameraManager call failed. error code: ${err.code}`);
}
return cameraManager;
}
3、通过CameraManager类中的getSupportedCameras方法,可获取当前装备支持的相机列表,列表中存储了所有的相机装备信息,包罗相机ID、位置、范例等。若列表不为空,列表中每个相机ID都支持独立创建相机对象;否则,说明当前装备无可用相机,不可继续后续操纵。
function getCameraDevices(cameraManager: camera.CameraManager): Array<camera.CameraDevice> {
let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
if (cameraArray != undefined && cameraArray.length > 0) {
for (let index = 0; index < cameraArray.length; index++) {
console.info('cameraId : ' + cameraArray.cameraId);// 获取相机ID
console.info('cameraPosition : ' + cameraArray.cameraPosition);// 获取相机位置,如前置或后置相机
console.info('cameraType : ' + cameraArray.cameraType);// 获取相机类型,如广角或景深相机
console.info('connectionType : ' + cameraArray.connectionType);// 获取相机连接类型,如内置、USB连接或远程(分布式)连接相机
console.info('cameraOrientation: ' + cameraArray.cameraOrientation); // 获取镜头的安装角度,不会随着屏幕旋转而改变,取值范围为0°-360°,API 12新增
}
return cameraArray;
} else {
console.error("cameraManager.getSupportedCameras error");
return [];
}
}
相机状态变革监听
在相机应用开发过程中,通过注册回调函数可以随时监听相机状态变革,包罗新相机的出现、相机的移除、相机的可用状态。在回调函数中,通过相机ID、相机状态这两个参数举行监听,如当有新相机出现时,可以将新相机加入到应用的相机列表中通知用户。
通过注册cameraStatus事件,callback返回CameraStatusInfo参数,包罗相机的信息CameraDevice和状态CameraStatus
function onCameraStatusChange(err: BusinessError, cameraStatusInfo:camera.CameraStatusInfo): void {
if (err !== undefined && err.code !== 0) {
console.error(`Callback Error, errorCode: ${err.code}`);
return;
}
// 当插入USB相机设备时,回调函数会返回新的相机出现状态
if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_APPEAR) {
console.info(`New Camera device appear.`);
}
// 当拔出USB相机设备时,回调函数会返回相机被移除状态
if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_DISAPPEAR) {
console.info(`Camera device has been removed.`);
}
// 相机被打开时,回调函数会返回相机可用状态
if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_AVAILABLE) {
console.info(`Current Camera is available.`);
}
// 相机被关闭/占用时,回调函数会返回相机不可用状态
if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_UNAVAILABLE) {
console.info(`Current Camera is unavailable.`);
}
console.info(`camera: ${cameraStatusInfo.camera.cameraId}`);
console.info(`status: ${cameraStatusInfo.status}`);
});
}
function registerCameraStatus(cameraManager: camera.CameraManager): void {
cameraManager.on('cameraStatus', onCameraStatusChange);
}
// 注销相机设备状态回调
function unregisterCameraStatus(cameraManager: camera.CameraManager): void {
cameraManager.off('cameraStatus');
}
API参考
camera.getCameraManager
getCameraManager(context: Context): CameraManager
获取相机管理器实例,同步返回结果,需传入UIAbility实例的上下文信息
getSupportedCameras
getSupportedCameras(): Array<CameraDevice>
interface CameraDevice {
readonly cameraId: string;
readonly cameraPosition: CameraPosition;
readonly cameraType: CameraType;
readonly connectionType: ConnectionType;
readonly cameraOrientation: number;
...
}
获取支持指定的相机装备对象,同步返回结果。
cameraStatus
on(type: 'cameraStatus', callback: AsyncCallback<CameraStatusInfo>): void
注册相机装备状态回调,通过注册回调函数获取相机的状态变革。使用callback异步回调。
off(type: 'cameraStatus', callback?: AsyncCallback<CameraStatusInfo>): void
取消注册相机装备状态回调,通过注销回调函数取消获取相机的状态变革。
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页:
[1]