OpenHarmony 媒体子系统开发常见问题

媒体子系统

使用XComponent组件显示相机的预览输出流时，如何获取相机的帧数据

问题现象

目前接口不支持实时预览相机的帧数据，只能绑定一个动作来获取，比如拍照动作。

解决措施

通过创建双路预览来实现。

// 获取PreviewOutput(预览输出类)实例
const surfaceId = globalThis.mxXComponentController.getXComponentSurfaceld();
this.mPreviewOutput = await Camera.createPreviewOutput(surfaceld);

// 添加双路预览
const fullWidth = this.mFullScreenSize.width;
const fullHeight = this.mFullScreenSize.height;
const imageReceiver = await image.createImageReceiver(fullwidth, fullHeight, 
  formatImage, capacityImage) ;
const photoSurfaceId = await imageReceiver.getReceivingSurfaceld();
this.mPreviewOutputDouble = await Camera.createPreviewOutput ( photoSurfaceld)

如何获取前置摄像头的预览图像

解决措施

1. 使用系统相机框架@ohos.multimedia.camera获取物理摄像头信息。

   let cameraManager = await camera.getCameraManager(context);
   let camerasInfo = await cameraManager.getSupportedCameras();
   let cameraDevice = this.camerasInfo[0];
   

2. 创建并启动物理摄像头输入流通道。

   let cameraInput = await cameraManager.createCameraInput(cameraDevice);
   await this.cameraInput.open();
   

3. 拿到物理摄像头信息查询摄像头支持预览流支持的输出格式，结合XComponent提供的surfaceId创建预览输出通道。

   let outputCapability = await this.cameraManager.getSupportedOutputCapability(cameraDevice);
   let previewProfile = this.outputCapability.previewProfiles[0];
   let previewOutput = await cameraManager.createPreviewOutput(previewProfile, previewId);
   

4. 创建相机会话，在会话中添加摄像头输入流和预览输出流，然后启动会话，预览画面就会在XComponent组件上送显。

   let captureSession = await cameraManager.createCaptureSession();
   await captureSession.beginConfig();
   await captureSession.addInput(cameraInput);
   await captureSession.addOutput(previewOutput);
   await this.captureSession.commitConfig()
   await this.captureSession.start();
   

如何设置相机焦距

解决措施

1. 判断当前摄像头是否为前置摄像头，前置摄像头不支持设置焦距。
2. 通过captureSession.getZoomRatioRange()接口获取设备焦距设置支持的最大、最小范围。
3. 判断目标焦距参数大小是否在步骤二获取的范围内，然后通过captureSession.setZoomRatio()接口设置相机焦距。

如何后台播放音乐

解决措施

AVSession对媒体播放做了管控，当三方应用从前台切入后台或者进入锁屏状态，媒体播放会被强制暂停而应用不感知，如果要开发后台播放功能，应该启动后台任务管理的长时任务中播放音乐，同时接入AVSession能力，允许控制中心的播控面板控制三方应用的播放功能。

参考链接

• 后台任务管理的长时任务开发指导参考
• AVSession开发指导参考

如何获取视频播放案例Sample

解决措施

可参考文档：

• Codelab

媒体库各公共路径支持的文件格式有哪些

创建多个视频组件无法播放

问题现象

创建十几个视频组件无法播放甚至崩溃。

解决措施

当前限制最多创建13个媒体播放实例。

媒体库的物理路径是什么

/storage/media/100/local/files/Pictures
/storage/media/100/local/files/Audios
/storage/media/100/local/files/Videos
/storage/media/100/local/files/Camera
/storage/media/100/local/files/Documents
/storage/media/100/local/files/Download

如何直接调起图片库

let want = {
  bundleName: 'com.ohos.photos',
  abilityName: 'com.ohos.photos.MainAbility',
  parameters: {
 uri: 'detail'
  }
};
let context = getContext(this) as common.UIAbilityContext;
context.startAbility(want);

如何使用JS语言开发相机功能

解决措施

参考文档：

• 相机开发概述

如何录制手机声卡的音频

解决措施

参考文档：

• 音频采集开发指导

调用媒体库getAlbums方法，需要申请什么权限

解决措施

1. 在module.json5中配置权限：

   "requestPermissions": [
     {
       "name": "ohos.permission.READ_MEDIA"
     }
   ]
   

2. 在EntryAbility.ts -> onWindowStageCreate页面加载前需要增加用户授权代码：

   let permissionList: Array<string> = [
     "ohos.permission.READ_MEDIA"
   ];
   this.context.requestPermissionsFromUser(permissionList)
     .then(data => {
       console.info(`request permission data result = ${data.authResults}`)
     })
     .catch(err => {
       console.error(`fail to request permission error:${err}`)
     })
   

如何播放h.265编码格式的MP4视频

解决措施

暂不支持h.265编码格式的MP4视频播放。

如何在Stage模型下调用mediaLibrary.getMediaLibrary()接口

解决措施

参考文档：

• 媒体资源使用指导

调用mediaLibrary.getFileAssets()接口返回的内容如何排序

解决措施

通过MediaFetchOptions对象参数里面的order属性进行排序。

V900单板openharmony媒体播放失败<406 no buffer>

解决措施

V900单板未适配HDI驱动， 需要厂商进行适配。

如何实现对图片类似Glide封装后形成的图片库

解决措施

通过imageknife三方库鸿蒙化实现

参考文档：

• imageknife

官方文档上有视屏录制VideoRecorder相关接口信息，但在SDK上却没有

解决措施

VideoRecorder已改为系统接口，建议使用AVRecorder替代。

参考文档：

• AVRecorder

如何申请设备上的媒体读写权限

解决措施

1. 在module.json5配置文件中配置媒体读写权限ohos.permission.READ_MEDIA和ohos.permission.WRITE_MEDIA。

   示例：

   {
     "module" : {
       "requestPermissions":[
         {
           "name" : "ohos.permission.READ_MEDIA",
           "reason": "$string:reason"
         },
         {
           "name" : "ohos.permission.WRITE_MEDIA",
           "reason": "$string:reason"
         }
       ]
     }
   }
   

2. 这两个权限的授权方式均为user_grant，因此需要调用requestPermissionsFromUser接口，以动态弹窗的方式向用户申请授权。

   let context = getContext(this) as common.UIAbilityContext;
   let atManager = abilityAccessCtrl.createAtManager();
   let permissions: Array<string> = ['ohos.permission.READ_MEDIA','ohos.permission.WRITE_MEDIA']
   atManager.requestPermissionsFromUser(context, permissions)
   .then((data) => {
       console.log("Succeed to request permission from user with data: " + JSON.stringify(data))
   }).catch((error) => {
       console.log("Failed to request permission from user with error: " + JSON.stringify(error))
   })
   

如何查询媒体库缩略图预览

解决措施

参考文档：

• 选择用户文件

如何检测当前相机服务的状态

解决措施

cameraManager通过设置状态回调返回相机状态。

cameraManager.on('cameraStatus', (cameraStatusInfo) => {
  console.log(`camera : ${cameraStatusInfo.camera.cameraId}`);
  console.log(`status: ${cameraStatusInfo.status}`);
})

相机状态：CameraStatus

枚举，相机状态。

• CAMERA_STATUS_APPEAR 0 新的相机出现。
• CAMERA_STATUS_DISAPPEAR 1 相机被移除。
• CAMERA_STATUS_AVAILABLE 2 相机可用。
• CAMERA_STATUS_UNAVAILABLE 3 相机不可用。

参考文档：

• CameraStatus