跳到主要内容

设备输入(ArkTS)

在开发相机应用时,需要先申请相关权限

相机应用可通过调用和控制相机设备,完成预览、拍照和录像等基础操作。

开发步骤

详细的API说明请参考@ohos.multimedia.camera (相机管理)

  1. 导入camera接口,接口中提供了相机相关的属性和方法,导入方法如下。

    import { camera } from '@kit.CameraKit';
    import { BusinessError } from '@kit.BasicServicesKit';

    在相机设备输入之前需要先完成相机管理,详细开发步骤请参考相机管理

  2. 通过cameraManager中的createCameraInput方法创建相机输入流。

    async function createInput(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Promise<camera.CameraInput | undefined> {
    // 创建相机输入流。
    let cameraInput: camera.CameraInput | undefined = undefined;
    try {
    cameraInput = cameraManager.createCameraInput(cameraDevice);
    } catch (error) {
    let err = error as BusinessError;
    console.error('Failed to createCameraInput errorCode = ' + err.code);
    }
    if (cameraInput === undefined) {
    return undefined;
    }
    // 监听cameraInput错误信息。
    cameraInput.on('error', cameraDevice, (error: BusinessError) => {
    console.error(`Camera input error code: ${error.code}`);
    });
    // 打开相机。
    await cameraInput.open();
    return cameraInput;
    }
  3. 通过getSupportedSceneModes方法,获取当前相机设备支持的模式列表,列表中存储了相机设备支持的所有模式SceneMode

    function getSupportedSceneMode(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Array<camera.SceneMode> {
    // 获取相机设备支持的模式列表。
    let sceneModeArray: Array<camera.SceneMode> = cameraManager.getSupportedSceneModes(cameraDevice);
    if (sceneModeArray != undefined && sceneModeArray.length > 0) {
    for (let index = 0; index < sceneModeArray.length; index++) {
    console.info('Camera SceneMode : ' + sceneModeArray[index]);
    }
    return sceneModeArray;
    } else {
    console.error("cameraManager.getSupportedSceneModes error");
    return [];
    }
    }
  4. 通过getSupportedOutputCapability方法,获取当前相机设备支持的所有输出流,如预览流、拍照流、录像流等。输出流在CameraOutputCapability中的各个profile字段中,根据相机设备指定模式SceneMode的不同,需要添加不同类型的输出流。

    async function getSupportedOutputCapability(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager, sceneMode: camera.SceneMode): Promise<camera.CameraOutputCapability | undefined> {
    // 获取相机设备支持的输出流能力。
    let cameraOutputCapability: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraDevice, sceneMode);
    if (!cameraOutputCapability) {
    console.error("cameraManager.getSupportedOutputCapability error");
    return undefined;
    }
    console.info("outputCapability: " + JSON.stringify(cameraOutputCapability));
    // 以NORMAL_PHOTO模式为例,需要添加预览流、拍照流。
    // previewProfiles属性为获取当前设备支持的预览输出流。
    let previewProfilesArray: Array<camera.Profile> = cameraOutputCapability.previewProfiles;
    if (!previewProfilesArray) {
    console.error("createOutput previewProfilesArray == null || undefined");
    }
    // photoProfiles属性为获取当前设备支持的拍照输出流。
    let photoProfilesArray: Array<camera.Profile> = cameraOutputCapability.photoProfiles;
    if (!photoProfilesArray) {
    console.error("createOutput photoProfilesArray == null || undefined");
    }
    return cameraOutputCapability;
    }