Skip to content

D
Docs

OpenHarmony / Docs
接近 2 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs
提交 7ee691ea 编写于 作者: Z zhangchao
浏览文件
操作

cameraFramework ArkTS规范整改 

Signed-off-by: Nzhangchao <zhangchao338@huawei.com>
上级 76d9efc0
隐藏空白更改
内联 并排
Showing with 574 addition and 575 deletion
zh-cn/application-dev/media/camera-device-input.md
浏览文件 @ 7ee691ea
...@@ -15,9 +15,9 @@ ...@@ -15,9 +15,9 @@
2. 通过getCameraManager()方法，获取cameraManager对象。 2. 通过getCameraManager()方法，获取cameraManager对象。
```ts ```ts
let cameraManager; let cameraManager: camera.CameraManager;
let context: any = getContext(this); let context: Context = getContext(this); // [各类Context的获取方式](../application-models/application-context-stage.md)
cameraManager = camera.getCameraManager(context) cameraManager = camera.getCameraManager(context);
``` ```
> **说明：** > **说明：**
...@@ -27,17 +27,17 @@ ...@@ -27,17 +27,17 @@
3. 通过cameraManager类中的getSupportedCameras()方法，获取当前设备支持的相机列表，列表中存储了设备支持的所有相机ID。若列表不为空，则说明列表中的每个ID都支持独立创建相机对象；否则，说明当前设备无可用相机，不可继续后续操作。 3. 通过cameraManager类中的getSupportedCameras()方法，获取当前设备支持的相机列表，列表中存储了设备支持的所有相机ID。若列表不为空，则说明列表中的每个ID都支持独立创建相机对象；否则，说明当前设备无可用相机，不可继续后续操作。
```ts ```ts
let cameraArray = cameraManager.getSupportedCameras(); let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
if (cameraArray.length <= 0) { if (cameraArray != undefined && cameraArray.length <= 0) {
console.error("cameraManager.getSupportedCameras error"); console.error("cameraManager.getSupportedCameras error");
return; return;
} }
for (let index = 0; index < cameraArray.length; index++) { for (let index = 0; index < cameraArray.length; index++) {
console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID
console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置 console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置
console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型 console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型
console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型 console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型
} }
``` ```
...@@ -45,24 +45,24 @@ ...@@ -45,24 +45,24 @@
```ts ```ts
// 创建相机输入流 // 创建相机输入流
let cameraInput; let cameraInput: camera.CameraInput;
try { try {
cameraInput = cameraManager.createCameraInput(cameraArray[0]); cameraInput = cameraManager.createCameraInput(cameraArray[0]);
} catch (error) { } catch (error) {
console.error('Failed to createCameraInput errorCode = ' + error.code); console.error('Failed to createCameraInput errorCode = ' + error.code);
} }
// 监听cameraInput错误信息 // 监听cameraInput错误信息
let cameraDevice = cameraArray[0]; let cameraDevice: camera.CameraDevice = cameraArray[0];
cameraInput.on('error', cameraDevice, (error) => { cameraInput.on('error', cameraDevice, (error: BusinessError) => {
console.info(`Camera input error code: ${error.code}`); console.info(`Camera input error code: ${error.code}`);
}) });
// 打开相机 // 打开相机
await cameraInput.open(); await cameraInput.open();
// 获取相机设备支持的输出流能力 // 获取相机设备支持的输出流能力
let cameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraArray[0]); let cameraOutputCapability: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraArray[0]);
if (!cameraOutputCapability) { if (!cameraOutputCapability) {
console.error("cameraManager.getSupportedOutputCapability error"); console.error("cameraManager.getSupportedOutputCapability error");
return; return;
} }
console.info("outputCapability: " + JSON.stringify(cameraOutputCapability)); console.info("outputCapability: " + JSON.stringify(cameraOutputCapability));
``` ```
...@@ -75,8 +75,8 @@ ...@@ -75,8 +75,8 @@
通过注册cameraStatus事件，通过回调返回监听结果，callback返回CameraStatusInfo参数，参数的具体内容可参考相机管理器回调接口实例[CameraStatusInfo](../reference/apis/js-apis-camera.md#camerastatusinfo)。 通过注册cameraStatus事件，通过回调返回监听结果，callback返回CameraStatusInfo参数，参数的具体内容可参考相机管理器回调接口实例[CameraStatusInfo](../reference/apis/js-apis-camera.md#camerastatusinfo)。
```ts ```ts
cameraManager.on('cameraStatus', (err, cameraStatusInfo) => { cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => {
console.info(`camera: ${cameraStatusInfo.camera.cameraId}`); console.info(`camera: ${cameraStatusInfo.camera.cameraId}`);
console.info(`status: ${cameraStatusInfo.status}`); console.info(`status: ${cameraStatusInfo.status}`);
}) });
``` ```
zh-cn/application-dev/media/camera-metadata.md
浏览文件 @ 7ee691ea
...@@ -11,13 +11,13 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递 ...@@ -11,13 +11,13 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递
1. 调用CameraOutputCapability类中的supportedMetadataObjectTypes()方法，获取当前设备支持的元数据类型，并通过createMetadataOutput()方法创建元数据输出流。 1. 调用CameraOutputCapability类中的supportedMetadataObjectTypes()方法，获取当前设备支持的元数据类型，并通过createMetadataOutput()方法创建元数据输出流。
```ts ```ts
let metadataObjectTypes = cameraOutputCapability.supportedMetadataObjectTypes; let metadataObjectTypes: Array<camera.MetadataObjectType> = cameraOutputCapability.supportedMetadataObjectTypes;
let metadataOutput; let metadataOutput: camera.MetadataOutput;
try { try {
metadataOutput = cameraManager.createMetadataOutput(metadataObjectTypes); metadataOutput = cameraManager.createMetadataOutput(metadataObjectTypes);
} catch (error) { } catch (error) {
// 失败返回错误码error.code并处理 // 失败返回错误码error.code并处理
console.info(error.code); console.info(error.code);
} }
``` ```
...@@ -25,9 +25,9 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递 ...@@ -25,9 +25,9 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递
```ts ```ts
metadataOutput.start().then(() => { metadataOutput.start().then(() => {
console.info('Callback returned with metadataOutput started.'); console.info('Callback returned with metadataOutput started.');
}).catch((err) => { }).catch((err) => {
console.info('Failed to metadataOutput start '+ err.code); console.info('Failed to metadataOutput start '+ err.code);
}); });
``` ```
...@@ -35,9 +35,9 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递 ...@@ -35,9 +35,9 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递
```ts ```ts
metadataOutput.stop().then(() => { metadataOutput.stop().then(() => {
console.info('Callback returned with metadataOutput stopped.'); console.info('Callback returned with metadataOutput stopped.');
}).catch((err) => { }).catch((err) => {
console.info('Failed to metadataOutput stop '+ err.code); console.info('Failed to metadataOutput stop '+ err.code);
}); });
``` ```
...@@ -48,9 +48,9 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递 ...@@ -48,9 +48,9 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递
- 通过注册监听获取metadata对象，监听事件固定为metadataObjectsAvailable。检测到有效metadata数据时，callback返回相应的metadata数据信息，metadataOutput创建成功时可监听。 - 通过注册监听获取metadata对象，监听事件固定为metadataObjectsAvailable。检测到有效metadata数据时，callback返回相应的metadata数据信息，metadataOutput创建成功时可监听。
```ts ```ts
metadataOutput.on('metadataObjectsAvailable', (err, metadataObjectArr) => { metadataOutput.on('metadataObjectsAvailable', (err: BusinessError, metadataObjectArr: Array<camera.MetadataObject>) => {
console.info(`metadata output metadataObjectsAvailable`); console.info(`metadata output metadataObjectsAvailable`);
}) });
``` ```
> **说明：** > **说明：**
...@@ -60,7 +60,7 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递 ...@@ -60,7 +60,7 @@ Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递
- 通过注册回调函数，获取监听metadata流的错误结果，callback返回metadata输出接口使用错误时返回的错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。 - 通过注册回调函数，获取监听metadata流的错误结果，callback返回metadata输出接口使用错误时返回的错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。
```ts ```ts
metadataOutput.on('error', (metadataOutputError) => { metadataOutput.on('error', (metadataOutputError: BusinessError) => {
console.info(`Metadata output error code: ${metadataOutputError.code}`); console.info(`Metadata output error code: ${metadataOutputError.code}`);
}) });
``` ```
zh-cn/application-dev/media/camera-mode.md
浏览文件 @ 7ee691ea
...@@ -11,248 +11,247 @@ ...@@ -11,248 +11,247 @@
## 完整示例 ## 完整示例
```ts ```ts
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera';
import image from '@ohos.multimedia.image' import image from '@ohos.multimedia.image';
import media from '@ohos.multimedia.media' import media from '@ohos.multimedia.media';
// 创建CameraManager对象 // 创建CameraManager对象
context: any = getContext(this) let context: Context = getContext(this); // [各类Context的获取方式](../application-models/application-context-stage.md)
let cameraManager = camera.getCameraManager(this.context) let cameraManager: camera.CameraManager = camera.getCameraManager(context);
if (!cameraManager) { if (!cameraManager) {
console.error("camera.getCameraManager error") console.error("camera.getCameraManager error");
return; return;
} }
// 创建ModeManager对象 // 创建ModeManager对象
context: any = getContext(this) let modeManager: camera.ModeManager = camera.getModeManager(context);
let modeManager = camera.getModeManager(this.context)
if (!cameraManager) { if (!cameraManager) {
console.error("camera.getModeManager error") console.error("camera.getModeManager error");
return; return;
} }
// 监听相机状态变化 // 监听相机状态变化
cameraManager.on('cameraStatus', (err, cameraStatusInfo) => { cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => {
console.info(`camera : ${cameraStatusInfo.camera.cameraId}`); console.info(`camera : ${cameraStatusInfo.camera.cameraId}`);
console.info(`status: ${cameraStatusInfo.status}`); console.info(`status: ${cameraStatusInfo.status}`);
}) });
// 获取相机列表 // 获取相机列表
let cameraArray = cameraManager.getSupportedCameras(); let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
if (cameraArray.length <= 0) { if (cameraArray.length <= 0) {
console.error("cameraManager.getSupportedCameras error") console.error("cameraManager.getSupportedCameras error");
return; return;
} }
for (let index = 0; index < cameraArray.length; index++) { for (let index = 0; index < cameraArray.length; index++) {
console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID
console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置 console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置
console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型 console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型
console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型 console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型
} }
// 获取模式列表 // 获取模式列表
let cameraModeArray = modeManager.getSupportedModes(cameraArray[0]); let cameraModeArray: Array<camera.CameraMode> = modeManager.getSupportedModes(cameraArray[0]);
if (cameraModeArray.length <= 0) { if (cameraModeArray.length <= 0) {
console.error("modeManager.getSupportedModes error") console.error("modeManager.getSupportedModes error");
return; return;
} }
// 创建相机输入流 // 创建相机输入流
let cameraInput let cameraInput: camera.CameraInput;
try { try {
cameraInput = cameraManager.createCameraInput(cameraArray[0]); cameraInput = cameraManager.createCameraInput(cameraArray[0]);
} catch (error) { } catch (error) {
console.error('Failed to createCameraInput errorCode = ' + error.code); console.error('Failed to createCameraInput errorCode = ' + error.code);
} }
// 监听cameraInput错误信息 // 监听cameraInput错误信息
let cameraDevice = cameraArray[0]; let cameraDevice: camera.CameraDevice = cameraArray[0];
cameraInput.on('error', cameraDevice, (error) => { cameraInput.on('error', cameraDevice, (error: BusinessError) => {
console.info(`Camera input error code: ${error.code}`); console.info(`Camera input error code: ${error.code}`);
}) })
// 打开相机 // 打开相机
await cameraInput.open(); await cameraInput.open();
// 获取当前模式相机设备支持的输出流能力 // 获取当前模式相机设备支持的输出流能力
let cameraOutputCap = modeManager.getSupportedOutputCapability(cameraArray[0], cameraModeArray[0]); let cameraOutputCap: camera.CameraOutputCapability = modeManager.getSupportedOutputCapability(cameraArray[0], cameraModeArray[0]);
if (!cameraOutputCap) { if (!cameraOutputCap) {
console.error("modeManager.getSupportedOutputCapability error") console.error("modeManager.getSupportedOutputCapability error")
return; return;
} }
console.info("outputCapability: " + JSON.stringify(cameraOutputCap)); console.info("outputCapability: " + JSON.stringify(cameraOutputCap));
let previewProfilesArray = cameraOutputCap.previewProfiles; let previewProfilesArray: Array<camera.Profile> = cameraOutputCap.previewProfiles;
if (!previewProfilesArray) { if (!previewProfilesArray) {
console.error("createOutput previewProfilesArray == null || undefined") console.error("createOutput previewProfilesArray == null || undefined")
} }
let photoProfilesArray = cameraOutputCap.photoProfiles; let photoProfilesArray: Array<camera.Profile> = cameraOutputCap.photoProfiles;
if (!photoProfilesArray) { if (!photoProfilesArray) {
console.error("createOutput photoProfilesArray == null || undefined") console.error("createOutput photoProfilesArray == null || undefined")
} }
// 创建预览输出流,其中参数 surfaceId 参考上文 XComponent 组件，预览流为XComponent组件提供的surface // 创建预览输出流,其中参数 surfaceId 参考上文 XComponent 组件，预览流为XComponent组件提供的surface
let previewOutput let previewOutput: camera.PreviewOutput;
try { try {
previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId) previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId);
} catch (error) { } catch (error) {
console.error("Failed to create the PreviewOutput instance.") console.error("Failed to create the PreviewOutput instance.");
} }
// 监听预览输出错误信息 // 监听预览输出错误信息
previewOutput.on('error', (error) => { previewOutput.on('error', (error: BusinessError) => {
console.info(`Preview output error code: ${error.code}`); console.info(`Preview output error code: ${error.code}`);
}) })
// 创建ImageReceiver对象，并设置照片参数：分辨率大小是根据前面 photoProfilesArray 获取的当前设备所支持的拍照分辨率大小去设置 // 创建ImageReceiver对象，并设置照片参数：分辨率大小是根据前面 photoProfilesArray 获取的当前设备所支持的拍照分辨率大小去设置
let imageReceiver = await image.createImageReceiver(1920, 1080, 4, 8) let imageReceiver: image.ImageReceiver = await image.createImageReceiver(1920, 1080, 4, 8)
// 获取照片显示SurfaceId // 获取照片显示SurfaceId
let photoSurfaceId = await imageReceiver.getReceivingSurfaceId() let photoSurfaceId: string = await imageReceiver.getReceivingSurfaceId()
// 创建拍照输出流 // 创建拍照输出流
let photoOutput let photoOutput: camera.PhotoOutput;
try { try {
photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId) photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId);
} catch (error) { } catch (error) {
console.error('Failed to createPhotoOutput errorCode = ' + error.code); console.error('Failed to createPhotoOutput errorCode = ' + error.code);
} }
//创建portrait会话 //创建portrait会话
let portraitSession let portraitSession: camera.CaptureSession;
try { try {
portraitSession = modeManager.createCaptureSession(cameraModeArray[0]) portraitSession = modeManager.createCaptureSession(cameraModeArray[0]);
} catch (error) { } catch (error) {
console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code); console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code);
} }
// 监听portraitSession错误信息 // 监听portraitSession错误信息
portraitSession.on('error', (error) => { portraitSession.on('error', (error: BusinessError) => {
console.info(`Capture session error code: ${error.code}`); console.info(`Capture session error code: ${error.code}`);
}) });
// 开始配置会话 // 开始配置会话
try { try {
portraitSession.beginConfig() portraitSession.beginConfig();
} catch (error) { } catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code); console.error('Failed to beginConfig. errorCode = ' + error.code);
} }
// 向会话中添加相机输入流 // 向会话中添加相机输入流
try { try {
portraitSession.addInput(cameraInput) portraitSession.addInput(cameraInput);
} catch (error) { } catch (error) {
console.error('Failed to addInput. errorCode = ' + error.code); console.error('Failed to addInput. errorCode = ' + error.code);
} }
// 向会话中添加预览输出流 // 向会话中添加预览输出流
try { try {
portraitSession.addOutput(previewOutput) portraitSession.addOutput(previewOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code); console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code);
} }
// 向会话中添加拍照输出流 // 向会话中添加拍照输出流
try { try {
portraitSession.addOutput(photoOutput) portraitSession.addOutput(photoOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code); console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code);
} }
// 提交会话配置 // 提交会话配置
await portraitSession.commitConfig() await portraitSession.commitConfig();
// 启动会话 // 启动会话
await portraitSession.start().then(() => { await portraitSession.start().then(() => {
console.info('Promise returned to indicate the session start success.'); console.info('Promise returned to indicate the session start success.');
}) })
// 获取支持的美颜类型 // 获取支持的美颜类型
let beautyTypes let beautyTypes: Array<camera.BeautyType>;
try { try {
beautyTypes = portraitSession.getSupportedBeautyTypes() beautyTypes = portraitSession.getSupportedBeautyTypes();
} catch (error) { } catch (error) {
console.error('Failed to get the beauty types. errorCode = ' + error.code); console.error('Failed to get the beauty types. errorCode = ' + error.code);
} }
// 获取支持的美颜类型对应的美颜强度范围 // 获取支持的美颜类型对应的美颜强度范围
let beautyRanges let beautyRanges: Array<number>;
try { try {
beautyRanges = portraitSession.getSupportedBeautyRanges(beautyTypes[0]) beautyRanges = portraitSession.getSupportedBeautyRanges(beautyTypes[0]);
} catch (error) { } catch (error) {
console.error('Failed to get the beauty types ranges. errorCode = ' + error.code); console.error('Failed to get the beauty types ranges. errorCode = ' + error.code);
} }
// 设置美颜类型及对应的美颜强度 // 设置美颜类型及对应的美颜强度
try { try {
portraitSession.setBeauty(beautyTypes[0], beautyRanges[0]) portraitSession.setBeauty(beautyTypes[0], beautyRanges[0]);
} catch (error) { } catch (error) {
console.error('Failed to set the beauty type value. errorCode = ' + error.code); console.error('Failed to set the beauty type value. errorCode = ' + error.code);
} }
// 获取已经设置的美颜类型对应的美颜强度 // 获取已经设置的美颜类型对应的美颜强度
let beautyLevel let beautyLevel: number;
try { try {
beautyLevel = portraitSession.getBeauty(beautyTypes[0]) beautyLevel = portraitSession.getBeauty(beautyTypes[0]);
} catch (error) { } catch (error) {
console.error('Failed to get the beauty type value. errorCode = ' + error.code); console.error('Failed to get the beauty type value. errorCode = ' + error.code);
} }
// 获取支持的滤镜类型 // 获取支持的滤镜类型
let filterTypes let filterTypes: Array<camera.FilterType>;
try { try {
filterTypes = portraitSession.getSupportedFilters() filterTypes = portraitSession.getSupportedFilters();
} catch (error) { } catch (error) {
console.error('Failed to get the filter types. errorCode = ' + error.code); console.error('Failed to get the filter types. errorCode = ' + error.code);
} }
// 设置滤镜类型 // 设置滤镜类型
try { try {
portraitSession.setFilter(filterTypes[0]) portraitSession.setFilter(filterTypes[0]);
} catch (error) { } catch (error) {
console.error('Failed to set the filter type value. errorCode = ' + error.code); console.error('Failed to set the filter type value. errorCode = ' + error.code);
} }
// 获取已经设置的滤镜类型 // 获取已经设置的滤镜类型
let filter let filter: number;
try { try {
filter = portraitSession.getFilter() filter = portraitSession.getFilter();
} catch (error) { } catch (error) {
console.error('Failed to get the filter type value. errorCode = ' + error.code); console.error('Failed to get the filter type value. errorCode = ' + error.code);
} }
// 获取支持的虚化类型 // 获取支持的虚化类型
let portraitTypes let portraitTypes: Array<camera.PortraitEffect>;
try { try {
portraitTypes = portraitSession.getSupportedPortraitEffects() portraitTypes = portraitSession.getSupportedPortraitEffects();
} catch (error) { } catch (error) {
console.error('Failed to get the portrait effects types. errorCode = ' + error.code); console.error('Failed to get the portrait effects types. errorCode = ' + error.code);
} }
// 设置虚化类型 // 设置虚化类型
try { try {
portraitSession.setPortraitEffect(portraitTypes[0]) portraitSession.setPortraitEffect(portraitTypes[0]);
} catch (error) { } catch (error) {
console.error('Failed to set the portrait effects value. errorCode = ' + error.code); console.error('Failed to set the portrait effects value. errorCode = ' + error.code);
} }
// 获取已经设置的虚化类型 // 获取已经设置的虚化类型
let effect let effect: camera.PortraitEffect;
try { try {
effect = portraitSession.getPortraitEffect() effect = portraitSession.getPortraitEffect();
} catch (error) { } catch (error) {
console.error('Failed to get the portrait effects value. errorCode = ' + error.code); console.error('Failed to get the portrait effects value. errorCode = ' + error.code);
} }
// 使用当前拍照设置进行拍照 // 使用当前拍照设置进行拍照
photoOutput.capture(settings, async (err) => { photoOutput.capture(settings, async (err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to capture the photo ${err.message}'); console.error('Failed to capture the photo ${err.message}');
return; return;
} }
console.info('Callback invoked to indicate the photo capture request success.'); console.info('Callback invoked to indicate the photo capture request success.');
}); });
// 停止当前会话 // 停止当前会话
portraitSession.stop() portraitSession.stop();
// 释放相机输入流 // 释放相机输入流
cameraInput.close() cameraInput.close();
// 释放预览输出流 // 释放预览输出流
previewOutput.release() previewOutput.release();
// 释放拍照输出流 // 释放拍照输出流
photoOutput.release() photoOutput.release();
// 释放会话 // 释放会话
portraitSession.release() portraitSession.release();
// 会话置空 // 会话置空
portraitSession = null portraitSession = null;
``` ```
zh-cn/application-dev/media/camera-performance-improvement.md
浏览文件 @ 7ee691ea
...@@ -36,10 +36,10 @@ import camera from '@ohos.multimedia.camera'; ...@@ -36,10 +36,10 @@ import camera from '@ohos.multimedia.camera';
function async preview(context: Context, cameraInfo: camera.Device, previewProfile: camera.Profile, photoProfile: camera.Profile, surfaceId: string): Promise<void> { function async preview(context: Context, cameraInfo: camera.Device, previewProfile: camera.Profile, photoProfile: camera.Profile, surfaceId: string): Promise<void> {
const cameraManager: camera.CameraManager = camera.getCameraManager(context); const cameraManager: camera.CameraManager = camera.getCameraManager(context);
const cameraInput camera.CameraInput = await cameraManager.createCameraInput(cameraInfo) const cameraInput camera.CameraInput = await cameraManager.createCameraInput(cameraInfo);
const previewOutput: camera.PreviewOutput = await cameraManager.createDeferredPreviewOutput(previewProfile); const previewOutput: camera.PreviewOutput = await cameraManager.createDeferredPreviewOutput(previewProfile);
const photoOutput: camera.PhotoOutput = await cameraManager.createPhotoOutput(photoProfile); const photoOutput: camera.PhotoOutput = await cameraManager.createPhotoOutput(photoProfile);
const session: camera.CaptureSession = await this.mCameraManager.createCaptureSession(); const session: camera.CaptureSession = await mCameraManager.createCaptureSession();
await session.beginConfig(); await session.beginConfig();
await session.addInput(cameraInput); await session.addInput(cameraInput);
await session.addOutput(previewOutput); await session.addOutput(previewOutput);
...@@ -80,32 +80,32 @@ function async preview(context: Context, cameraInfo: camera.Device, previewProfi ...@@ -80,32 +80,32 @@ function async preview(context: Context, cameraInfo: camera.Device, previewProfi
![](figures/quick-thumbnail-sequence-diagram.png) ![](figures/quick-thumbnail-sequence-diagram.png)
```js ```js
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera';
let context: Context = getContext(this); // [各类Context的获取方式](../application-models/application-context-stage.md)
this.cameraManager = camera.getCameraManager(globalThis.abilityContext); let cameraManager: camera.CameraManager = camera.getCameraManager(context);
let cameras = this.cameraManager.getSupportedCameras() let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
// 创建CaptureSession实例 // 创建CaptureSession实例
this.captureSession = await this.cameraManager.createCaptureSession() let captureSession: camera.CaptureSession = await cameraManager.createCaptureSession();
// 开始配置会话 // 开始配置会话
await this.captureSession.beginConfig() await captureSession.beginConfig();
// 把CameraInput加入到会话 // 把CameraInput加入到会话
this.cameraInput = await this.cameraManager.createCameraInput(cameras[0]) let cameraInput: camera.CameraInput = await cameraManager.createCameraInput(cameras[0]);
await this.cameraInput.open() await cameraInput.open();
await this.captureSession.addInput(this.cameraInput) await captureSession.addInput(cameraInput);
// 把PhotoOutPut加入到会话 // 把PhotoOutPut加入到会话
this.photoOutPut = await this.cameraManager.createPhotoOutput(photoProfile, surfaceId) let photoOutPut: camera.PhotoOutput = await cameraManager.createPhotoOutput(photoProfile, surfaceId);
await this.captureSession.addOutput(this.photoOutPut) await captureSession.addOutput(photoOutPut);
boolean isSupported = this.photoOutPut.isQuickThumbnailSupported() let isSupported: boolean = photoOutPut.isQuickThumbnailSupported();
if (isSupported) { if (isSupported) {
// 使能快速缩略图 // 使能快速缩略图
this.photoOutPut.enableQuickThumbnail(true) photoOutPut.enableQuickThumbnail(true);
this.photoOutPut.on('quickThumbnail', (err, pixelmap) => { photoOutPut.on('quickThumbnail', (err: BusinessError, pixelmap: image.PixelMap) => {
if (err || pixelmap === undefined) { if (err || pixelmap === undefined) {
Logger.error(this.tag, 'photoOutPut on thumbnail failed ') console.error('photoOutPut on thumbnail failed');
return return;
} }
// 显示或保存pixelmap // 显示或保存pixelmap
this.showOrSavePicture(pixelmap) showOrSavePicture(pixelmap);
}) })
} }
``` ```
...@@ -138,13 +138,13 @@ if (isSupported) { ...@@ -138,13 +138,13 @@ if (isSupported) {
- **桌面应用** - **桌面应用**
```js ```js
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera';
this.cameraManager = camera.getCameraManager(globalThis.abilityContext); let cameraManager: camera.CameraManager = camera.getCameraManager(globalThis.abilityContext);
try { try {
this.cameraManager.prelaunch(); cameraManager.prelaunch();
} catch (error) { } catch (error) {
console.error(`catch error: Code: ${error.code}, message: ${error.message}`) console.error(`catch error: Code: ${error.code}, message: ${error.message}`);
} }
``` ```
...@@ -155,15 +155,15 @@ if (isSupported) { ...@@ -155,15 +155,15 @@ if (isSupported) {
具体申请方式及校验方式，请参考[访问控制授权申请指导](../security/accesstoken-guidelines.md)。 具体申请方式及校验方式，请参考[访问控制授权申请指导](../security/accesstoken-guidelines.md)。
```js ```js
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera';
this.cameraManager = camera.getCameraManager(globalThis.abilityContext); cameraManager: camera.CameraManager = camera.getCameraManager(globalThis.abilityContext);
let cameras = this.cameraManager.getSupportedCameras() let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
if(this.cameraManager.isPrelaunchSupported(cameras[0])) { if(cameraManager.isPrelaunchSupported(cameras[0])) {
try { try {
this.cameraManager.setPrelaunchConfig({cameraDevice: cameras[0]}); cameraManager.setPrelaunchConfig({cameraDevice: cameras[0]});
} catch (error) { } catch (error) {
console.error(`catch error: Code: ${error.code}, message: ${error.message}`) console.error(`catch error: Code: ${error.code}, message: ${error.message}`);
} }
} }
``` ```
zh-cn/application-dev/media/camera-preview.md
浏览文件 @ 7ee691ea
...@@ -14,36 +14,36 @@ ...@@ -14,36 +14,36 @@
// 创建XComponentController // 创建XComponentController
mXComponentController: XComponentController = new XComponentController; mXComponentController: XComponentController = new XComponentController;
build() { build() {
Flex() { Flex() {
// 创建XComponent // 创建XComponent
XComponent({ XComponent({
id: '', id: '',
type: 'surface', type: 'surface',
libraryname: '', libraryname: '',
controller: this.mXComponentController controller: this.mXComponentController
}) })
.onLoad(() => { .onLoad(() => {
// 设置Surface宽高（1920*1080），预览尺寸设置参考前面 previewProfilesArray 获取的当前设备所支持的预览分辨率大小去设置 // 设置Surface宽高（1920*1080），预览尺寸设置参考前面 previewProfilesArray 获取的当前设备所支持的预览分辨率大小去设置
this.mXComponentController.setXComponentSurfaceSize({surfaceWidth:1920,surfaceHeight:1080}); this.mXComponentController.setXComponentSurfaceSize({surfaceWidth:1920,surfaceHeight:1080});
// 获取Surface ID // 获取Surface ID
globalThis.surfaceId = this.mXComponentController.getXComponentSurfaceId(); globalThis.surfaceId = this.mXComponentController.getXComponentSurfaceId();
}) })
.width('1920px') .width('1920px')
.height('1080px') .height('1080px')
} }
} }
``` ```
2. 通过CameraOutputCapability类中的previewProfiles()方法获取当前设备支持的预览能力，返回previewProfilesArray数组 。通过createPreviewOutput()方法创建预览输出流，其中，createPreviewOutput()方法中的两个参数分别是previewProfilesArray数组中的第一项和步骤一中获取的surfaceId。 2. 通过CameraOutputCapability类中的previewProfiles()方法获取当前设备支持的预览能力，返回previewProfilesArray数组 。通过createPreviewOutput()方法创建预览输出流，其中，createPreviewOutput()方法中的两个参数分别是previewProfilesArray数组中的第一项和步骤一中获取的surfaceId。
```ts ```ts
let previewProfilesArray = cameraOutputCapability.previewProfiles; let previewProfilesArray: Array<camera.Profile> = cameraOutputCapability.previewProfiles;
let previewOutput; let previewOutput: camera.PreviewOutput;
try { try {
previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId); previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId);
} }
catch (error) { catch (error) {
console.error("Failed to create the PreviewOutput instance." + error); console.error("Failed to create the PreviewOutput instance." + error);
} }
``` ```
...@@ -51,9 +51,9 @@ ...@@ -51,9 +51,9 @@
```ts ```ts
previewOutput.start().then(() => { previewOutput.start().then(() => {
console.info('Callback returned with previewOutput started.'); console.info('Callback returned with previewOutput started.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.info('Failed to previewOutput start '+ err.code); console.info('Failed to previewOutput start '+ err.code);
}); });
``` ```
...@@ -66,22 +66,22 @@ ...@@ -66,22 +66,22 @@
```ts ```ts
previewOutput.on('frameStart', () => { previewOutput.on('frameStart', () => {
console.info('Preview frame started'); console.info('Preview frame started');
}) });
``` ```
- 通过注册固定的frameEnd回调函数获取监听预览结束结果，previewOutput创建成功时即可监听，预览完成最后一帧时触发，有该事件返回结果则认为预览流已结束。 - 通过注册固定的frameEnd回调函数获取监听预览结束结果，previewOutput创建成功时即可监听，预览完成最后一帧时触发，有该事件返回结果则认为预览流已结束。
```ts ```ts
previewOutput.on('frameEnd', () => { previewOutput.on('frameEnd', () => {
console.info('Preview frame ended'); console.info('Preview frame ended');
}) });
``` ```
- 通过注册固定的error回调函数获取监听预览输出错误结果，callback返回预览输出接口使用错误时对应的错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。 - 通过注册固定的error回调函数获取监听预览输出错误结果，callback返回预览输出接口使用错误时对应的错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。
```ts ```ts
previewOutput.on('error', (previewOutputError) => { previewOutput.on('error', (previewOutputError: BusinessError) => {
console.info(`Preview output error code: ${previewOutputError.code}`); console.info(`Preview output error code: ${previewOutputError.code}`);
}) });
``` ```
zh-cn/application-dev/media/camera-recording-case.md
浏览文件 @ 7ee691ea
...@@ -10,238 +10,238 @@ ...@@ -10,238 +10,238 @@
## 完整示例 ## 完整示例
```ts ```ts
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera';
import media from '@ohos.multimedia.media' import media from '@ohos.multimedia.media';
// 创建CameraManager对象 // 创建CameraManager对象
context: any = getContext(this) let context: Context = getContext(this); // [各类Context的获取方式](../application-models/application-context-stage.md)
let cameraManager = camera.getCameraManager(this.context) let cameraManager: camera.CameraManager = camera.getCameraManager(context);
if (!cameraManager) { if (!cameraManager) {
console.error("camera.getCameraManager error") console.error("camera.getCameraManager error");
return; return;
} }
// 监听相机状态变化 // 监听相机状态变化
cameraManager.on('cameraStatus', (err, cameraStatusInfo) => { cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => {
console.log(`camera : ${cameraStatusInfo.camera.cameraId}`); console.log(`camera : ${cameraStatusInfo.camera.cameraId}`);
console.log(`status: ${cameraStatusInfo.status}`); console.log(`status: ${cameraStatusInfo.status}`);
}) });
// 获取相机设备支持的输出流能力 // 获取相机设备支持的输出流能力
let cameraOutputCap = cameraManager.getSupportedOutputCapability(cameraArray[0]); let cameraOutputCap: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraArray[0]);
if (!cameraOutputCap) { if (!cameraOutputCap) {
console.error("cameraManager.getSupportedOutputCapability error") console.error("cameraManager.getSupportedOutputCapability error")
return; return;
} }
console.log("outputCapability: " + JSON.stringify(cameraOutputCap)); console.log("outputCapability: " + JSON.stringify(cameraOutputCap));
let previewProfilesArray = cameraOutputCap.previewProfiles; let previewProfilesArray: Array<camera.Profile> = cameraOutputCap.previewProfiles;
if (!previewProfilesArray) { if (!previewProfilesArray) {
console.error("createOutput previewProfilesArray == null || undefined") console.error("createOutput previewProfilesArray == null || undefined");
} }
let photoProfilesArray = cameraOutputCap.photoProfiles; let photoProfilesArray: Array<camera.Profile> = cameraOutputCap.photoProfiles;
if (!photoProfilesArray) { if (!photoProfilesArray) {
console.error("createOutput photoProfilesArray == null || undefined") console.error("createOutput photoProfilesArray == null || undefined");
} }
let videoProfilesArray = cameraOutputCap.videoProfiles; let videoProfilesArray: Array<camera.VideoProfile> = cameraOutputCap.videoProfiles;
if (!videoProfilesArray) { if (!videoProfilesArray) {
console.error("createOutput videoProfilesArray == null || undefined") console.error("createOutput videoProfilesArray == null || undefined");
} }
let metadataObjectTypesArray = cameraOutputCap.supportedMetadataObjectTypes; let metadataObjectTypesArray: Array<camera.MetadataObjectType> = cameraOutputCap.supportedMetadataObjectTypes;
if (!metadataObjectTypesArray) { if (!metadataObjectTypesArray) {
console.error("createOutput metadataObjectTypesArray == null || undefined") console.error("createOutput metadataObjectTypesArray == null || undefined");
} }
// 配置参数以实际硬件设备支持的范围为准 // 配置参数以实际硬件设备支持的范围为准
let AVRecorderProfile = { let AVRecorderProfile = {
audioBitrate : 48000, audioBitrate : 48000,
audioChannels : 2, audioChannels : 2,
audioCodec : media.CodecMimeType.AUDIO_AAC, audioCodec : media.CodecMimeType.AUDIO_AAC,
audioSampleRate : 48000, audioSampleRate : 48000,
fileFormat : media.ContainerFormatType.CFT_MPEG_4, fileFormat : media.ContainerFormatType.CFT_MPEG_4,
videoBitrate : 2000000, videoBitrate : 2000000,
videoCodec : media.CodecMimeType.VIDEO_MPEG4, videoCodec : media.CodecMimeType.VIDEO_MPEG4,
videoFrameWidth : 640, videoFrameWidth : 640,
videoFrameHeight : 480, videoFrameHeight : 480,
videoFrameRate : 30 videoFrameRate : 30
} };
let AVRecorderConfig = { let AVRecorderConfig = {
audioSourceType : media.AudioSourceType.AUDIO_SOURCE_TYPE_MIC, audioSourceType : media.AudioSourceType.AUDIO_SOURCE_TYPE_MIC,
videoSourceType : media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV, videoSourceType : media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV,
profile : AVRecorderProfile, profile : AVRecorderProfile,
url : 'fd://', // 文件需先由调用者创建，赋予读写权限，将文件fd传给此参数，eg.fd://45--file:///data/media/01.mp4 url : 'fd://', // 文件需先由调用者创建，赋予读写权限，将文件fd传给此参数，eg.fd://45--file:///data/media/01.mp4
rotation : 0, // 合理值0、90、180、270，非合理值prepare接口将报错 rotation : 0, // 合理值0、90、180、270，非合理值prepare接口将报错
location : { latitude : 30, longitude : 130 } location : { latitude : 30, longitude : 130 }
} };
let avRecorder let avRecorder: media.AVRecorder;
media.createAVRecorder((error, recorder) => { media.createAVRecorder((error: BusinessError, recorder: media.AVRecorder) => {
if (recorder != null) { if (recorder != null) {
avRecorder = recorder; avRecorder = recorder;
console.log('createAVRecorder success'); console.log('createAVRecorder success');
} else { } else {
console.log(`createAVRecorder fail, error:${error}`); console.log(`createAVRecorder fail, error:${error}`);
} }
}); });
avRecorder.prepare(AVRecorderConfig, (err) => { avRecorder.prepare(AVRecorderConfig: media.AVRecorderConfig, (err: BusinessError) => {
if (err == null) { if (err == null) {
console.log('prepare success'); console.log('prepare success');
} else { } else {
console.log('prepare failed and error is ' + err.message); console.log('prepare failed and error is ' + err.message);
} }
}) })
let videoSurfaceId = null; // 该surfaceID用于传递给相机接口创造videoOutput let videoSurfaceId: string = null; // 该surfaceID用于传递给相机接口创造videoOutput
avRecorder.getInputSurface((err, surfaceId) => { avRecorder.getInputSurface((err: BusinessError, surfaceId: string) => {
if (err == null) { if (err == null) {
console.log('getInputSurface success'); console.log('getInputSurface success');
videoSurfaceId = surfaceId; videoSurfaceId = surfaceId;
} else { } else {
console.log('getInputSurface failed and error is ' + err.message); console.log('getInputSurface failed and error is ' + err.message);
} }
}); });
// 创建VideoOutput对象 // 创建VideoOutput对象
let videoOutput let videoOutput: camera.VideoOutput;
try { try {
videoOutput = cameraManager.createVideoOutput(videoProfilesArray[0], videoSurfaceId) videoOutput = cameraManager.createVideoOutput(videoProfilesArray[0], videoSurfaceId)
} catch (error) { } catch (error) {
console.error('Failed to create the videoOutput instance. errorCode = ' + error.code); console.error('Failed to create the videoOutput instance. errorCode = ' + error.code);
} }
// 监听视频输出错误信息 // 监听视频输出错误信息
videoOutput.on('error', (error) => { videoOutput.on('error', (error: BusinessError) => {
console.log(`Preview output error code: ${error.code}`); console.log(`Preview output error code: ${error.code}`);
}) });
//创建会话 //创建会话
let captureSession let captureSession: camera.CaptureSession;
try { try {
captureSession = cameraManager.createCaptureSession() captureSession = cameraManager.createCaptureSession();
} catch (error) { } catch (error) {
console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code); console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code);
} }
// 监听session错误信息 // 监听session错误信息
captureSession.on('error', (error) => { captureSession.on('error', (error: BusinessError) => {
console.log(`Capture session error code: ${error.code}`); console.log(`Capture session error code: ${error.code}`);
}) });
// 开始配置会话 // 开始配置会话
try { try {
captureSession.beginConfig() captureSession.beginConfig();
} catch (error) { } catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code); console.error('Failed to beginConfig. errorCode = ' + error.code);
} }
// 获取相机列表 // 获取相机列表
let cameraArray = cameraManager.getSupportedCameras(); let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
if (cameraArray.length <= 0) { if (cameraArray.length <= 0) {
console.error("cameraManager.getSupportedCameras error") console.error("cameraManager.getSupportedCameras error")
return; return;
} }
// 创建相机输入流 // 创建相机输入流
let cameraInput let cameraInput: camera.CameraInput;
try { try {
cameraInput = cameraManager.createCameraInput(cameraArray[0]); cameraInput = cameraManager.createCameraInput(cameraArray[0]);
} catch (error) { } catch (error) {
console.error('Failed to createCameraInput errorCode = ' + error.code); console.error('Failed to createCameraInput errorCode = ' + error.code);
} }
// 监听cameraInput错误信息 // 监听cameraInput错误信息
let cameraDevice = cameraArray[0]; let cameraDevice: camera.CameraDevice = cameraArray[0];
cameraInput.on('error', cameraDevice, (error) => { cameraInput.on('error', cameraDevice, (error: BusinessError) => {
console.log(`Camera input error code: ${error.code}`); console.log(`Camera input error code: ${error.code}`);
}) });
// 打开相机 // 打开相机
await cameraInput.open(); await cameraInput.open();
// 向会话中添加相机输入流 // 向会话中添加相机输入流
try { try {
captureSession.addInput(cameraInput) captureSession.addInput(cameraInput);
} catch (error) { } catch (error) {
console.error('Failed to addInput. errorCode = ' + error.code); console.error('Failed to addInput. errorCode = ' + error.code);
} }
// 创建预览输出流,其中参数 surfaceId 参考下面 XComponent 组件，预览流为XComponent组件提供的surface // 创建预览输出流,其中参数 surfaceId 参考下面 XComponent 组件，预览流为XComponent组件提供的surface
let previewOutput let previewOutput: camera.PreviewOutput;
try { try {
previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId) previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId);
} catch (error) { } catch (error) {
console.error("Failed to create the PreviewOutput instance.") console.error("Failed to create the PreviewOutput instance.")
} }
// 向会话中添加预览输入流 // 向会话中添加预览输入流
try { try {
captureSession.addOutput(previewOutput) captureSession.addOutput(previewOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code); console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code);
} }
// 向会话中添加录像输出流 // 向会话中添加录像输出流
try { try {
captureSession.addOutput(videoOutput) captureSession.addOutput(videoOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(videoOutput). errorCode = ' + error.code); console.error('Failed to addOutput(videoOutput). errorCode = ' + error.code);
} }
// 提交会话配置 // 提交会话配置
await captureSession.commitConfig() await captureSession.commitConfig();
// 启动会话 // 启动会话
await captureSession.start().then(() => { await captureSession.start().then(() => {
console.log('Promise returned to indicate the session start success.'); console.log('Promise returned to indicate the session start success.');
}) });
// 启动录像输出流 // 启动录像输出流
videoOutput.start(async (err) => { videoOutput.start(async (err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to start the video output ${err.message}'); console.error('Failed to start the video output ${err.message}');
return; return;
} }
console.log('Callback invoked to indicate the video output start success.'); console.log('Callback invoked to indicate the video output start success.');
}); });
// 开始录像 // 开始录像
avRecorder.start().then(() => { avRecorder.start().then(() => {
console.log('videoRecorder start success'); console.log('videoRecorder start success');
}) });
// 停止录像输出流 // 停止录像输出流
videoOutput.stop((err) => { videoOutput.stop((err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to stop the video output ${err.message}'); console.error('Failed to stop the video output ${err.message}');
return; return;
} }
console.log('Callback invoked to indicate the video output stop success.'); console.log('Callback invoked to indicate the video output stop success.');
}); });
// 停止录像 // 停止录像
avRecorder.stop().then(() => { avRecorder.stop().then(() => {
console.log('stop success'); console.log('stop success');
}) });
// 停止当前会话 // 停止当前会话
captureSession.stop() captureSession.stop();
// 释放相机输入流 // 释放相机输入流
cameraInput.close() cameraInput.close();
// 释放预览输出流 // 释放预览输出流
previewOutput.release() previewOutput.release();
// 释放录像输出流 // 释放录像输出流
videoOutput.release() videoOutput.release();
// 释放会话 // 释放会话
captureSession.release() captureSession.release();
// 会话置空 // 会话置空
captureSession = null captureSession = null;
``` ```
zh-cn/application-dev/media/camera-recording.md
浏览文件 @ 7ee691ea
...@@ -17,30 +17,30 @@ ...@@ -17,30 +17,30 @@
系统提供的media接口可以创建一个录像AVRecorder实例，通过该实例的getInputSurface方法获取SurfaceId，与录像输出流做关联，处理录像输出流输出的数据。 系统提供的media接口可以创建一个录像AVRecorder实例，通过该实例的getInputSurface方法获取SurfaceId，与录像输出流做关联，处理录像输出流输出的数据。
```ts ```ts
let AVRecorder; let avRecorder: media.AVRecorder;
media.createAVRecorder((error, recorder) => { media.createAVRecorder((error: BusinessError, recorder: media.AVRecorder) => {
if (recorder != null) { if (recorder != null) {
AVRecorder = recorder; avRecorder = recorder;
console.info('createAVRecorder success'); console.info('createAVRecorder success');
} else { } else {
console.info(`createAVRecorder fail, error:${error}`); console.info(`createAVRecorder fail, error:${error}`);
} }
}); });
// AVRecorderConfig可参考下一章节 // AVRecorderConfig可参考下一章节
AVRecorder.prepare(AVRecorderConfig, (err) => { avRecorder.prepare(AVRecorderConfig: media.AVRecorderConfig, (err: BusinessError) => {
if (err == null) { if (err == null) {
console.log('prepare success'); console.log('prepare success');
} else { } else {
console.log('prepare failed and error is ' + err.message); console.log('prepare failed and error is ' + err.message);
} }
}) });
let videoSurfaceId = null; let videoSurfaceId: string = null;
AVRecorder.getInputSurface().then((surfaceId) => { avRecorder.getInputSurface().then((surfaceId: string) => {
console.info('getInputSurface success'); console.info('getInputSurface success');
videoSurfaceId = surfaceId; videoSurfaceId = surfaceId;
}).catch((err) => { }).catch((err) => {
console.info('getInputSurface failed and catch error is ' + err.message); console.info('getInputSurface failed and catch error is ' + err.message);
}); });
``` ```
...@@ -49,43 +49,43 @@ ...@@ -49,43 +49,43 @@
通过CameraOutputCapability类中的videoProfiles，可获取当前设备支持的录像输出流。然后，定义创建录像的参数，通过createVideoOutput方法创建录像输出流。 通过CameraOutputCapability类中的videoProfiles，可获取当前设备支持的录像输出流。然后，定义创建录像的参数，通过createVideoOutput方法创建录像输出流。
```ts ```ts
let videoProfilesArray = cameraOutputCapability.videoProfiles; let videoProfilesArray: Array<camera.VideoProfile> = cameraOutputCapability.videoProfiles;
if (!videoProfilesArray) { if (!videoProfilesArray) {
console.error("createOutput videoProfilesArray == null || undefined"); console.error("createOutput videoProfilesArray == null || undefined");
} }
// 创建视频录制的参数 // 创建视频录制的参数
let videoConfig = { let videoConfig = {
videoSourceType: media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV, videoSourceType: media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV,
profile: { profile: {
fileFormat : media.ContainerFormatType.CFT_MPEG_4, // 视频文件封装格式，只支持MP4 fileFormat : media.ContainerFormatType.CFT_MPEG_4, // 视频文件封装格式，只支持MP4
videoBitrate : 100000, // 视频比特率 videoBitrate : 100000, // 视频比特率
videoCodec : media.CodecMimeType.VIDEO_MPEG4, // 视频文件编码格式，支持mpeg4和avc两种格式 videoCodec : media.CodecMimeType.VIDEO_MPEG4, // 视频文件编码格式，支持mpeg4和avc两种格式
videoFrameWidth : 640, // 视频分辨率的宽 videoFrameWidth : 640, // 视频分辨率的宽
videoFrameHeight : 480, // 视频分辨率的高 videoFrameHeight : 480, // 视频分辨率的高
videoFrameRate : 30 // 视频帧率 videoFrameRate : 30 // 视频帧率
}, },
url: 'fd://35', url: 'fd://35',
rotation: 90 // 90°为默认竖屏显示角度，如果由于设备原因或应用期望以其他方式显示等原因，请根据实际情况调整该参数 rotation: 90 // 90°为默认竖屏显示角度，如果由于设备原因或应用期望以其他方式显示等原因，请根据实际情况调整该参数
} }
// 创建avRecorder // 创建avRecorder
let avRecorder; let avRecorder: media.AVRecorder;
media.createAVRecorder((error, recorder) => { media.createAVRecorder((error: BusinessError, recorder: media.AVRecorder) => {
if (recorder != null) { if (recorder != null) {
avRecorder = recorder; avRecorder = recorder;
console.info('createAVRecorder success'); console.info('createAVRecorder success');
} else { } else {
console.info(`createAVRecorder fail, error:${error}`); console.info(`createAVRecorder fail, error:${error}`);
} }
}); });
// 设置视频录制的参数 // 设置视频录制的参数
avRecorder.prepare(videoConfig); avRecorder.prepare(videoConfig);
// 创建VideoOutput对象 // 创建VideoOutput对象
let videoOutput; let videoOutput: camera.VideoOutput;
try { try {
videoOutput = cameraManager.createVideoOutput(videoProfilesArray[0], videoSurfaceId); videoOutput = cameraManager.createVideoOutput(videoProfilesArray[0], videoSurfaceId);
} catch (error) { } catch (error) {
console.error('Failed to create the videoOutput instance. errorCode = ' + error.code); console.error('Failed to create the videoOutput instance. errorCode = ' + error.code);
} }
``` ```
...@@ -93,17 +93,17 @@ ...@@ -93,17 +93,17 @@
先通过videoOutput的start方法启动录像输出流，再通过avRecorder的start方法开始录像。 先通过videoOutput的start方法启动录像输出流，再通过avRecorder的start方法开始录像。
``` ```ts
videoOutput.start(async (err) => { videoOutput.start(async (err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to start the video output ${err.message}'); console.error('Failed to start the video output ${err.message}');
return; return;
} }
console.info('Callback invoked to indicate the video output start success.'); console.info('Callback invoked to indicate the video output start success.');
}); });
avRecorder.start().then(() => { avRecorder.start().then(() => {
console.info('avRecorder start success'); console.info('avRecorder start success');
}); });
``` ```
...@@ -113,15 +113,15 @@ ...@@ -113,15 +113,15 @@
```ts ```ts
videoRecorder.stop().then(() => { videoRecorder.stop().then(() => {
console.info('stop success'); console.info('stop success');
}); });
videoOutput.stop((err) => { videoOutput.stop((err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to stop the video output ${err.message}'); console.error('Failed to stop the video output ${err.message}');
return; return;
} }
console.info('Callback invoked to indicate the video output stop success.'); console.info('Callback invoked to indicate the video output stop success.');
}); });
``` ```
...@@ -134,22 +134,22 @@ ...@@ -134,22 +134,22 @@
```ts ```ts
videoOutput.on('frameStart', () => { videoOutput.on('frameStart', () => {
console.info('Video frame started'); console.info('Video frame started');
}) });
``` ```
- 通过注册固定的frameEnd回调函数获取监听录像结束结果，videoOutput创建成功时即可监听，录像完成最后一帧时触发，有该事件返回结果则认为录像流已结束。 - 通过注册固定的frameEnd回调函数获取监听录像结束结果，videoOutput创建成功时即可监听，录像完成最后一帧时触发，有该事件返回结果则认为录像流已结束。
```ts ```ts
videoOutput.on('frameEnd', () => { videoOutput.on('frameEnd', () => {
console.info('Video frame ended'); console.info('Video frame ended');
}) });
``` ```
- 通过注册固定的error回调函数获取监听录像输出错误结果，callback返回预览输出接口使用错误时对应的错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。 - 通过注册固定的error回调函数获取监听录像输出错误结果，callback返回预览输出接口使用错误时对应的错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。
```ts ```ts
videoOutput.on('error', (error) => { videoOutput.on('error', (error: BusinessError) => {
console.info(`Video output error code: ${error.code}`); console.info(`Video output error code: ${error.code}`);
}) });
``` ```
zh-cn/application-dev/media/camera-session-management.md
浏览文件 @ 7ee691ea
...@@ -18,11 +18,11 @@ ...@@ -18,11 +18,11 @@
1. 调用cameraManager类中的createCaptureSession()方法创建一个会话。 1. 调用cameraManager类中的createCaptureSession()方法创建一个会话。
```ts ```ts
let captureSession; let captureSession: camera.CaptureSession;
try { try {
captureSession = cameraManager.createCaptureSession(); captureSession = cameraManager.createCaptureSession();
} catch (error) { } catch (error) {
console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code); console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code);
} }
``` ```
...@@ -30,9 +30,9 @@ ...@@ -30,9 +30,9 @@
```ts ```ts
try { try {
captureSession.beginConfig(); captureSession.beginConfig();
} catch (error) { } catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code); console.error('Failed to beginConfig. errorCode = ' + error.code);
} }
``` ```
...@@ -42,24 +42,24 @@ ...@@ -42,24 +42,24 @@
```ts ```ts
try { try {
captureSession.addInput(cameraInput); captureSession.addInput(cameraInput);
} catch (error) { } catch (error) {
console.error('Failed to addInput. errorCode = ' + error.code); console.error('Failed to addInput. errorCode = ' + error.code);
} }
try { try {
captureSession.addOutput(previewOutput); captureSession.addOutput(previewOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code); console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code);
} }
try { try {
captureSession.addOutput(photoOutput); captureSession.addOutput(photoOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code); console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code);
} }
await captureSession.commitConfig() ; await captureSession.commitConfig();
await captureSession.start().then(() => { await captureSession.start().then(() => {
console.info('Promise returned to indicate the session start success.'); console.info('Promise returned to indicate the session start success.');
}) });
``` ```
4. 会话控制。调用captureSession类中的stop()方法可以停止当前会话。调用removeOutput()和addOutput()方法可以完成会话切换控制。以下示例代码以移除拍照流photoOutput，添加视频流videoOutput为例，完成了拍照到录像的切换。 4. 会话控制。调用captureSession类中的stop()方法可以停止当前会话。调用removeOutput()和addOutput()方法可以完成会话切换控制。以下示例代码以移除拍照流photoOutput，添加视频流videoOutput为例，完成了拍照到录像的切换。
...@@ -67,20 +67,20 @@ ...@@ -67,20 +67,20 @@
```ts ```ts
await captureSession.stop(); await captureSession.stop();
try { try {
captureSession.beginConfig(); captureSession.beginConfig();
} catch (error) { } catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code); console.error('Failed to beginConfig. errorCode = ' + error.code);
} }
// 从会话中移除拍照输出流 // 从会话中移除拍照输出流
try { try {
captureSession.removeOutput(photoOutput); captureSession.removeOutput(photoOutput);
} catch (error) { } catch (error) {
console.error('Failed to removeOutput(photoOutput). errorCode = ' + error.code); console.error('Failed to removeOutput(photoOutput). errorCode = ' + error.code);
} }
// 向会话中添加视频输出流 // 向会话中添加视频输出流
try { try {
captureSession.addOutput(videoOutput); captureSession.addOutput(videoOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(videoOutput). errorCode = ' + error.code); console.error('Failed to addOutput(videoOutput). errorCode = ' + error.code);
} }
``` ```
zh-cn/application-dev/media/camera-shooting-case.md
浏览文件 @ 7ee691ea
...@@ -9,232 +9,232 @@ ...@@ -9,232 +9,232 @@
## 完整示例 ## 完整示例
```ts ```ts
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera';
import image from '@ohos.multimedia.image' import image from '@ohos.multimedia.image';
import media from '@ohos.multimedia.media' import media from '@ohos.multimedia.media';
// 创建CameraManager对象 // 创建CameraManager对象
context: any = getContext(this) let context: Context = getContext(this); // [各类Context的获取方式](../application-models/application-context-stage.md)
let cameraManager = camera.getCameraManager(this.context) let cameraManager: camera.CameraManager = camera.getCameraManager(context);
if (!cameraManager) { if (!cameraManager) {
console.error("camera.getCameraManager error") console.error("camera.getCameraManager error");
return; return;
} }
// 监听相机状态变化 // 监听相机状态变化
cameraManager.on('cameraStatus', (err, cameraStatusInfo) => { cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => {
console.info(`camera : ${cameraStatusInfo.camera.cameraId}`); console.info(`camera : ${cameraStatusInfo.camera.cameraId}`);
console.info(`status: ${cameraStatusInfo.status}`); console.info(`status: ${cameraStatusInfo.status}`);
}) });
// 获取相机列表 // 获取相机列表
let cameraArray = cameraManager.getSupportedCameras(); let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
if (cameraArray.length <= 0) { if (cameraArray.length <= 0) {
console.error("cameraManager.getSupportedCameras error") console.error("cameraManager.getSupportedCameras error");
return; return;
} }
for (let index = 0; index < cameraArray.length; index++) { for (let index = 0; index < cameraArray.length; index++) {
console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID
console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置 console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置
console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型 console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型
console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型 console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型
} }
// 创建相机输入流 // 创建相机输入流
let cameraInput let cameraInput: camera.CameraInput;
try { try {
cameraInput = cameraManager.createCameraInput(cameraArray[0]); cameraInput = cameraManager.createCameraInput(cameraArray[0]);
} catch (error) { } catch (error) {
console.error('Failed to createCameraInput errorCode = ' + error.code); console.error('Failed to createCameraInput errorCode = ' + error.code);
} }
// 监听cameraInput错误信息 // 监听cameraInput错误信息
let cameraDevice = cameraArray[0]; let cameraDevice: camera.CameraDevice = cameraArray[0];
cameraInput.on('error', cameraDevice, (error) => { cameraInput.on('error', cameraDevice, (error: BusinessError) => {
console.info(`Camera input error code: ${error.code}`); console.info(`Camera input error code: ${error.code}`);
}) })
// 打开相机 // 打开相机
await cameraInput.open(); await cameraInput.open();
// 获取相机设备支持的输出流能力 // 获取相机设备支持的输出流能力
let cameraOutputCap = cameraManager.getSupportedOutputCapability(cameraArray[0]); let cameraOutputCap: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraArray[0]);
if (!cameraOutputCap) { if (!cameraOutputCap) {
console.error("cameraManager.getSupportedOutputCapability error") console.error("cameraManager.getSupportedOutputCapability error");
return; return;
} }
console.info("outputCapability: " + JSON.stringify(cameraOutputCap)); console.info("outputCapability: " + JSON.stringify(cameraOutputCap));
let previewProfilesArray = cameraOutputCap.previewProfiles; let previewProfilesArray: Array<camera.Profile> = cameraOutputCap.previewProfiles;
if (!previewProfilesArray) { if (!previewProfilesArray) {
console.error("createOutput previewProfilesArray == null || undefined") console.error("createOutput previewProfilesArray == null || undefined");
} }
let photoProfilesArray = cameraOutputCap.photoProfiles; let photoProfilesArray: Array<camera.Profile> = cameraOutputCap.photoProfiles;
if (!photoProfilesArray) { if (!photoProfilesArray) {
console.error("createOutput photoProfilesArray == null || undefined") console.error("createOutput photoProfilesArray == null || undefined");
} }
// 创建预览输出流,其中参数 surfaceId 参考上文 XComponent 组件，预览流为XComponent组件提供的surface // 创建预览输出流,其中参数 surfaceId 参考上文 XComponent 组件，预览流为XComponent组件提供的surface
let previewOutput let previewOutput: camera.PreviewOutput;
try { try {
previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId) previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId);
} catch (error) { } catch (error) {
console.error("Failed to create the PreviewOutput instance.") console.error("Failed to create the PreviewOutput instance.");
} }
// 监听预览输出错误信息 // 监听预览输出错误信息
previewOutput.on('error', (error) => { previewOutput.on('error', (error: BusinessError) => {
console.info(`Preview output error code: ${error.code}`); console.info(`Preview output error code: ${error.code}`);
}) });
// 创建ImageReceiver对象，并设置照片参数：分辨率大小是根据前面 photoProfilesArray 获取的当前设备所支持的拍照分辨率大小去设置 // 创建ImageReceiver对象，并设置照片参数：分辨率大小是根据前面 photoProfilesArray 获取的当前设备所支持的拍照分辨率大小去设置
let imageReceiver = await image.createImageReceiver(1920, 1080, 4, 8) let imageReceiver: image.ImageReceiver = await image.createImageReceiver(1920, 1080, 4, 8);
// 获取照片显示SurfaceId // 获取照片显示SurfaceId
let photoSurfaceId = await imageReceiver.getReceivingSurfaceId() let photoSurfaceId: string = await imageReceiver.getReceivingSurfaceId();
// 创建拍照输出流 // 创建拍照输出流
let photoOutput let photoOutput: camera.PhotoOutput;
try { try {
photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId) photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId);
} catch (error) { } catch (error) {
console.error('Failed to createPhotoOutput errorCode = ' + error.code); console.error('Failed to createPhotoOutput errorCode = ' + error.code);
} }
//创建会话 //创建会话
let captureSession let captureSession: camera.CaptureSession;
try { try {
captureSession = cameraManager.createCaptureSession() captureSession = cameraManager.createCaptureSession();
} catch (error) { } catch (error) {
console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code); console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code);
} }
// 监听session错误信息 // 监听session错误信息
captureSession.on('error', (error) => { captureSession.on('error', (error: BusinessError) => {
console.info(`Capture session error code: ${error.code}`); console.info(`Capture session error code: ${error.code}`);
}) });
// 开始配置会话 // 开始配置会话
try { try {
captureSession.beginConfig() captureSession.beginConfig();
} catch (error) { } catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code); console.error('Failed to beginConfig. errorCode = ' + error.code);
} }
// 向会话中添加相机输入流 // 向会话中添加相机输入流
try { try {
captureSession.addInput(cameraInput) captureSession.addInput(cameraInput);
} catch (error) { } catch (error) {
console.error('Failed to addInput. errorCode = ' + error.code); console.error('Failed to addInput. errorCode = ' + error.code);
} }
// 向会话中添加预览输出流 // 向会话中添加预览输出流
try { try {
captureSession.addOutput(previewOutput) captureSession.addOutput(previewOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code); console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code);
} }
// 向会话中添加拍照输出流 // 向会话中添加拍照输出流
try { try {
captureSession.addOutput(photoOutput) captureSession.addOutput(photoOutput);
} catch (error) { } catch (error) {
console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code); console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code);
} }
// 提交会话配置 // 提交会话配置
await captureSession.commitConfig() await captureSession.commitConfig();
// 启动会话 // 启动会话
await captureSession.start().then(() => { await captureSession.start().then(() => {
console.info('Promise returned to indicate the session start success.'); console.info('Promise returned to indicate the session start success.');
}) });
// 判断设备是否支持闪光灯 // 判断设备是否支持闪光灯
let flashStatus let flashStatus: boolean;
try { try {
flashStatus = captureSession.hasFlash() flashStatus = captureSession.hasFlash();
} catch (error) { } catch (error) {
console.error('Failed to hasFlash. errorCode = ' + error.code); console.error('Failed to hasFlash. errorCode = ' + error.code);
} }
console.info('Promise returned with the flash light support status:' + flashStatus); console.info('Promise returned with the flash light support status:' + flashStatus);
if (flashStatus) { if (flashStatus) {
// 判断是否支持自动闪光灯模式 // 判断是否支持自动闪光灯模式
let flashModeStatus let flashModeStatus: boolean;
try {
let status: boolean = captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO);
flashModeStatus = status;
} catch (error) {
console.error('Failed to check whether the flash mode is supported. errorCode = ' + error.code);
}
if(flashModeStatus) {
// 设置自动闪光灯模式
try { try {
let status = captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO) captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO);
flashModeStatus = status
} catch (error) { } catch (error) {
console.error('Failed to check whether the flash mode is supported. errorCode = ' + error.code); console.error('Failed to set the flash mode. errorCode = ' + error.code);
}
if(flashModeStatus) {
// 设置自动闪光灯模式
try {
captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO)
} catch (error) {
console.error('Failed to set the flash mode. errorCode = ' + error.code);
}
} }
}
} }
// 判断是否支持连续自动变焦模式 // 判断是否支持连续自动变焦模式
let focusModeStatus let focusModeStatus: boolean;
try { try {
let status = captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO) let status: boolean = captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO);
focusModeStatus = status focusModeStatus = status;
} catch (error) { } catch (error) {
console.error('Failed to check whether the focus mode is supported. errorCode = ' + error.code); console.error('Failed to check whether the focus mode is supported. errorCode = ' + error.code);
} }
if (focusModeStatus) { if (focusModeStatus) {
// 设置连续自动变焦模式 // 设置连续自动变焦模式
try { try {
captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO) captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO);
} catch (error) { } catch (error) {
console.error('Failed to set the focus mode. errorCode = ' + error.code); console.error('Failed to set the focus mode. errorCode = ' + error.code);
} }
} }
// 获取相机支持的可变焦距比范围 // 获取相机支持的可变焦距比范围
let zoomRatioRange let zoomRatioRange;
try { try {
zoomRatioRange = captureSession.getZoomRatioRange() zoomRatioRange: Array<number> = captureSession.getZoomRatioRange();
} catch (error) { } catch (error) {
console.error('Failed to get the zoom ratio range. errorCode = ' + error.code); console.error('Failed to get the zoom ratio range. errorCode = ' + error.code);
} }
// 设置可变焦距比 // 设置可变焦距比
try { try {
captureSession.setZoomRatio(zoomRatioRange[0]) captureSession.setZoomRatio(zoomRatioRange[0]);
} catch (error) { } catch (error) {
console.error('Failed to set the zoom ratio value. errorCode = ' + error.code); console.error('Failed to set the zoom ratio value. errorCode = ' + error.code);
} }
let settings = { let settings: camera.PhotoCaptureSetting = {
quality: camera.QualityLevel.QUALITY_LEVEL_HIGH, // 设置图片质量高 quality: camera.QualityLevel.QUALITY_LEVEL_HIGH, // 设置图片质量高
rotation: camera.ImageRotation.ROTATION_0 // 设置图片旋转角度0 rotation: camera.ImageRotation.ROTATION_0 // 设置图片旋转角度0
} }
// 使用当前拍照设置进行拍照 // 使用当前拍照设置进行拍照
photoOutput.capture(settings, async (err) => { photoOutput.capture(settings, async (err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to capture the photo ${err.message}'); console.error('Failed to capture the photo ${err.message}');
return; return;
} }
console.info('Callback invoked to indicate the photo capture request success.'); console.info('Callback invoked to indicate the photo capture request success.');
}); });
// 停止当前会话 // 停止当前会话
captureSession.stop() captureSession.stop();
// 释放相机输入流 // 释放相机输入流
cameraInput.close() cameraInput.close();
// 释放预览输出流 // 释放预览输出流
previewOutput.release() previewOutput.release();
// 释放拍照输出流 // 释放拍照输出流
photoOutput.release() photoOutput.release();
// 释放会话 // 释放会话
captureSession.release() captureSession.release();
// 会话置空 // 会话置空
captureSession = null captureSession = null;
``` ```
zh-cn/application-dev/media/camera-shooting.md
浏览文件 @ 7ee691ea
...@@ -18,15 +18,15 @@ ...@@ -18,15 +18,15 @@
```ts ```ts
function getImageReceiverSurfaceId() { function getImageReceiverSurfaceId() {
let receiver = image.createImageReceiver(640, 480, 4, 8); let receiver: image.ImageReceiver = image.createImageReceiver(640, 480, 4, 8);
console.info('before ImageReceiver check'); console.info('before ImageReceiver check');
if (receiver !== undefined) { if (receiver !== undefined) {
console.info('ImageReceiver is ok'); console.info('ImageReceiver is ok');
let photoSurfaceId = receiver.getReceivingSurfaceId(); let photoSurfaceId: string = receiver.getReceivingSurfaceId();
console.info('ImageReceived id: ' + JSON.stringify(photoSurfaceId)); console.info('ImageReceived id: ' + JSON.stringify(photoSurfaceId));
} else { } else {
console.info('ImageReceiver is not ok'); console.info('ImageReceiver is not ok');
} }
} }
``` ```
...@@ -35,15 +35,15 @@ ...@@ -35,15 +35,15 @@
通过CameraOutputCapability类中的photoProfiles()方法，可获取当前设备支持的拍照输出流，通过createPhotoOutput()方法传入支持的某一个输出流及步骤一获取的SurfaceId创建拍照输出流。 通过CameraOutputCapability类中的photoProfiles()方法，可获取当前设备支持的拍照输出流，通过createPhotoOutput()方法传入支持的某一个输出流及步骤一获取的SurfaceId创建拍照输出流。
```ts ```ts
let photoProfilesArray = cameraOutputCapability.photoProfiles; let photoProfilesArray: Array<camera.Profile> = cameraOutputCapability.photoProfiles;
if (!photoProfilesArray) { if (!photoProfilesArray) {
console.error("createOutput photoProfilesArray == null || undefined"); console.error("createOutput photoProfilesArray == null || undefined");
} }
let photoOutput; let photoOutput: camera.PhotoOutput;
try { try {
photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId); photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId);
} catch (error) { } catch (error) {
console.error('Failed to createPhotoOutput errorCode = ' + error.code); console.error('Failed to createPhotoOutput errorCode = ' + error.code);
} }
``` ```
...@@ -53,59 +53,59 @@ ...@@ -53,59 +53,59 @@
```ts ```ts
// 判断设备是否支持闪光灯 // 判断设备是否支持闪光灯
let flashStatus; let flashStatus: boolean;
try { try {
flashStatus = captureSession.hasFlash(); flashStatus = captureSession.hasFlash();
} catch (error) { } catch (error) {
console.error('Failed to hasFlash. errorCode = ' + error.code); console.error('Failed to hasFlash. errorCode = ' + error.code);
} }
console.info('Promise returned with the flash light support status:' + flashStatus); console.info('Promise returned with the flash light support status:' + flashStatus);
if (flashStatus) { if (flashStatus) {
// 判断是否支持自动闪光灯模式 // 判断是否支持自动闪光灯模式
let flashModeStatus; let flashModeStatus: boolean;
try {
let status: boolean = captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO);
flashModeStatus = status;
} catch (error) {
console.error('Failed to check whether the flash mode is supported. errorCode = ' + error.code);
}
if(flashModeStatus) {
// 设置自动闪光灯模式
try { try {
let status = captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO); captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO);
flashModeStatus = status;
} catch (error) { } catch (error) {
console.error('Failed to check whether the flash mode is supported. errorCode = ' + error.code); console.error('Failed to set the flash mode. errorCode = ' + error.code);
}
if(flashModeStatus) {
// 设置自动闪光灯模式
try {
captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO);
} catch (error) {
console.error('Failed to set the flash mode. errorCode = ' + error.code);
}
} }
}
} }
// 判断是否支持连续自动变焦模式 // 判断是否支持连续自动变焦模式
let focusModeStatus; let focusModeStatus: boolean;
try { try {
let status = captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO); let status: boolean = captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO);
focusModeStatus = status; focusModeStatus = status;
} catch (error) { } catch (error) {
console.error('Failed to check whether the focus mode is supported. errorCode = ' + error.code); console.error('Failed to check whether the focus mode is supported. errorCode = ' + error.code);
} }
if (focusModeStatus) { if (focusModeStatus) {
// 设置连续自动变焦模式 // 设置连续自动变焦模式
try { try {
captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO); captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO);
} catch (error) { } catch (error) {
console.error('Failed to set the focus mode. errorCode = ' + error.code); console.error('Failed to set the focus mode. errorCode = ' + error.code);
} }
} }
// 获取相机支持的可变焦距比范围 // 获取相机支持的可变焦距比范围
let zoomRatioRange; let zoomRatioRange: Array<number>;
try { try {
zoomRatioRange = captureSession.getZoomRatioRange(); zoomRatioRange = captureSession.getZoomRatioRange();
} catch (error) { } catch (error) {
console.error('Failed to get the zoom ratio range. errorCode = ' + error.code); console.error('Failed to get the zoom ratio range. errorCode = ' + error.code);
} }
// 设置可变焦距比 // 设置可变焦距比
try { try {
captureSession.setZoomRatio(zoomRatioRange[0]); captureSession.setZoomRatio(zoomRatioRange[0]);
} catch (error) { } catch (error) {
console.error('Failed to set the zoom ratio value. errorCode = ' + error.code); console.error('Failed to set the zoom ratio value. errorCode = ' + error.code);
} }
``` ```
...@@ -114,18 +114,18 @@ ...@@ -114,18 +114,18 @@
通过photoOutput类的capture()方法，执行拍照任务。该方法有两个参数，第一个参数为拍照设置参数的setting，setting中可以设置照片的质量和旋转角度，第二参数为回调函数。 通过photoOutput类的capture()方法，执行拍照任务。该方法有两个参数，第一个参数为拍照设置参数的setting，setting中可以设置照片的质量和旋转角度，第二参数为回调函数。
```ts ```ts
let settings = { let settings: camera.PhotoCaptureSetting = {
quality: camera.QualityLevel.QUALITY_LEVEL_HIGH, // 设置图片质量高 quality: camera.QualityLevel.QUALITY_LEVEL_HIGH, // 设置图片质量高
rotation: camera.ImageRotation.ROTATION_0, // 设置图片旋转角度0 rotation: camera.ImageRotation.ROTATION_0, // 设置图片旋转角度0
location: captureLocation, // 设置图片地理位置 location: captureLocation, // 设置图片地理位置
mirror: false // 设置镜像使能开关(默认关) mirror: false // 设置镜像使能开关(默认关)
}; };
photoOutput.capture(settings, async (err) => { photoOutput.capture(settings, async (err: BusinessError) => {
if (err) { if (err) {
console.error('Failed to capture the photo ${err.message}'); console.error('Failed to capture the photo ${err.message}');
return; return;
} }
console.info('Callback invoked to indicate the photo capture request success.'); console.info('Callback invoked to indicate the photo capture request success.');
}); });
``` ```
...@@ -136,24 +136,24 @@ ...@@ -136,24 +136,24 @@
- 通过注册固定的captureStart回调函数获取监听拍照开始结果，photoOutput创建成功时即可监听，拍照第一次曝光时触发，该事件返回此次拍照的captureId。 - 通过注册固定的captureStart回调函数获取监听拍照开始结果，photoOutput创建成功时即可监听，拍照第一次曝光时触发，该事件返回此次拍照的captureId。
```ts ```ts
photoOutput.on('captureStart', (err, captureId) => { photoOutput.on('captureStart', (err: BusinessError, captureId: number) => {
console.info(`photo capture stated, captureId : ${captureId}`); console.info(`photo capture stated, captureId : ${captureId}`);
}) });
``` ```
- 通过注册固定的captureEnd回调函数获取监听拍照结束结果，photoOutput创建成功时即可监听，该事件返回结果为拍照完全结束后的相关信息[CaptureEndInfo](../reference/apis/js-apis-camera.md#captureendinfo)。 - 通过注册固定的captureEnd回调函数获取监听拍照结束结果，photoOutput创建成功时即可监听，该事件返回结果为拍照完全结束后的相关信息[CaptureEndInfo](../reference/apis/js-apis-camera.md#captureendinfo)。
```ts ```ts
photoOutput.on('captureEnd', (err, captureEndInfo) => { photoOutput.on('captureEnd', (err: BusinessError, captureEndInfo: camera.CaptureEndInfo) => {
console.info(`photo capture end, captureId : ${captureEndInfo.captureId}`); console.info(`photo capture end, captureId : ${captureEndInfo.captureId}`);
console.info(`frameCount : ${captureEndInfo.frameCount}`); console.info(`frameCount : ${captureEndInfo.frameCount}`);
}) });
``` ```
- 通过注册固定的error回调函数获取监听拍照输出流的错误结果。callback返回拍照输出接口使用错误时的对应错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。 - 通过注册固定的error回调函数获取监听拍照输出流的错误结果。callback返回拍照输出接口使用错误时的对应错误码，错误码类型参见[CameraErrorCode](../reference/apis/js-apis-camera.md#cameraerrorcode)。
```ts ```ts
photoOutput.on('error', (error) => { photoOutput.on('error', (error: BusinessError) => {
console.info(`Photo output error code: ${error.code}`); console.info(`Photo output error code: ${error.code}`);
}) });
``` ```
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或