Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 c0c4b527 编写于 作者: Mr-YX's avatar Mr-YX 提交者： Gitee
浏览文件
操作

Signed-off-by: mr-yx <496043997@qq.com>

上级 afdc4a0f
隐藏空白更改
内联 并排
Showing with 101 addition and 106 deletion
zh-cn/application-dev/media/audio-overview.md
浏览文件 @ c0c4b527
...@@ -2,7 +2,6 @@ ...@@ -2,7 +2,6 @@
音频模块支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音量管理等。 音频模块支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音量管理等。
## 基本概念 ## 基本概念
- **采样**<br/> - **采样**<br/>
......
zh-cn/application-dev/media/audio-renderer.md
浏览文件 @ c0c4b527
...@@ -22,8 +22,6 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可 ...@@ -22,8 +22,6 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可
为保证UI线程不被阻塞，大部分AudioRenderer调用都是异步的。对于每个API均提供了callback函数和Promise函数，以下示例均采用Promise函数，更多方式可参考[音频管理API文档AudioRenderer](../reference/apis/js-apis-audio.md#audiorenderer8)。 为保证UI线程不被阻塞，大部分AudioRenderer调用都是异步的。对于每个API均提供了callback函数和Promise函数，以下示例均采用Promise函数，更多方式可参考[音频管理API文档AudioRenderer](../reference/apis/js-apis-audio.md#audiorenderer8)。
## 开发步骤 ## 开发步骤
1. 使用createAudioRenderer()创建一个AudioRenderer实例。 1. 使用createAudioRenderer()创建一个AudioRenderer实例。
...@@ -33,7 +31,7 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可 ...@@ -33,7 +31,7 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可
var audioStreamInfo = { var audioStreamInfo = {
samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100, samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
channels: audio.AudioChannel.CHANNEL_1, channels: audio.AudioChannel.CHANNEL_1,
sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE, sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
} }
...@@ -60,49 +58,49 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可 ...@@ -60,49 +58,49 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可
在音频中断的情况下，应用可能会碰到音频数据写入失败的问题。所以建议不感知、不处理中断的应用在写入音频数据前，使用audioRenderer.state检查播放器状态。而订阅音频中断事件，可以获取到更多详细信息，具体可参考[InterruptEvent](../reference/apis/js-apis-audio.md#interruptevent9)。 在音频中断的情况下，应用可能会碰到音频数据写入失败的问题。所以建议不感知、不处理中断的应用在写入音频数据前，使用audioRenderer.state检查播放器状态。而订阅音频中断事件，可以获取到更多详细信息，具体可参考[InterruptEvent](../reference/apis/js-apis-audio.md#interruptevent9)。
```js ```js
audioRenderer.on('interrupt', (interruptEvent) => { audioRenderer.on('interrupt', (interruptEvent) => {
console.info('InterruptEvent Received'); console.info('InterruptEvent Received');
console.info('InterruptType: ' + interruptEvent.eventType); console.info('InterruptType: ' + interruptEvent.eventType);
console.info('InterruptForceType: ' + interruptEvent.forceType); console.info('InterruptForceType: ' + interruptEvent.forceType);
console.info('AInterruptHint: ' + interruptEvent.hintType); console.info('AInterruptHint: ' + interruptEvent.hintType);
if (interruptEvent.forceType == audio.InterruptForceType.INTERRUPT_FORCE) { if (interruptEvent.forceType == audio.InterruptForceType.INTERRUPT_FORCE) {
switch (interruptEvent.hintType) { switch (interruptEvent.hintType) {
// Force Pause: Action was taken by framework. // Force Pause: Action was taken by framework.
// Halt the write calls to avoid data loss. // Halt the write calls to avoid data loss.
case audio.InterruptHint.INTERRUPT_HINT_PAUSE: case audio.InterruptHint.INTERRUPT_HINT_PAUSE:
isPlay = false; isPlay = false;
break; break;
// Force Stop: Action was taken by framework. // Force Stop: Action was taken by framework.
// Halt the write calls to avoid data loss. // Halt the write calls to avoid data loss.
case audio.InterruptHint.INTERRUPT_HINT_STOP: case audio.InterruptHint.INTERRUPT_HINT_STOP:
isPlay = false; isPlay = false;
break; break;
// Force Duck: Action was taken by framework, // Force Duck: Action was taken by framework,
// just notifying the app that volume has been reduced. // just notifying the app that volume has been reduced.
case audio.InterruptHint.INTERRUPT_HINT_DUCK: case audio.InterruptHint.INTERRUPT_HINT_DUCK:
break; break;
// Force Unduck: Action was taken by framework, // Force Unduck: Action was taken by framework,
// just notifying the app that volume has been restored. // just notifying the app that volume has been restored.
case audio.InterruptHint.INTERRUPT_HINT_UNDUCK: case audio.InterruptHint.INTERRUPT_HINT_UNDUCK:
break; break;
} }
} else if (interruptEvent.forceType == audio.InterruptForceType.INTERRUPT_SHARE) { } else if (interruptEvent.forceType == audio.InterruptForceType.INTERRUPT_SHARE) {
switch (interruptEvent.hintType) { switch (interruptEvent.hintType) {
// Share Resume: Action is to be taken by App. // Share Resume: Action is to be taken by App.
// Resume the force paused stream if required. // Resume the force paused stream if required.
case audio.InterruptHint.INTERRUPT_HINT_RESUME: case audio.InterruptHint.INTERRUPT_HINT_RESUME:
startRenderer(); startRenderer();
break; break;
// Share Pause: Stream has been interrupted, // Share Pause: Stream has been interrupted,
// It can choose to pause or play concurrently. // It can choose to pause or play concurrently.
case audio.InterruptHint.INTERRUPT_HINT_PAUSE: case audio.InterruptHint.INTERRUPT_HINT_PAUSE:
isPlay = false; isPlay = false;
pauseRenderer(); pauseRenderer();
break; break;
} }
} }
}); });
``` ```
3. 调用start()方法来启动/恢复播放任务。 3. 调用start()方法来启动/恢复播放任务。
...@@ -180,38 +178,38 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可 ...@@ -180,38 +178,38 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可
5. （可选）调用pause()方法或stop()方法暂停/停止渲染音频数据。 5. （可选）调用pause()方法或stop()方法暂停/停止渲染音频数据。
```js ```js
async function pauseRenderer() { async function pauseRenderer() {
var state = audioRenderer.state; var state = audioRenderer.state;
if (state != audio.AudioState.STATE_RUNNING) { if (state != audio.AudioState.STATE_RUNNING) {
console.info('Renderer is not running'); console.info('Renderer is not running');
return; return;
} }
await audioRenderer.pause(); await audioRenderer.pause();
state = audioRenderer.state; state = audioRenderer.state;
if (state == audio.AudioState.STATE_PAUSED) { if (state == audio.AudioState.STATE_PAUSED) {
console.info('Renderer paused'); console.info('Renderer paused');
} else { } else {
console.error('Renderer pause failed'); console.error('Renderer pause failed');
} }
} }
async function stopRenderer() {
var state = audioRenderer.state;
if (state != audio.AudioState.STATE_RUNNING || state != audio.AudioState.STATE_PAUSED) {
console.info('Renderer is not running or paused');
return;
}
await audioRenderer.stop();
state = audioRenderer.state; async function stopRenderer() {
if (state == audio.AudioState.STATE_STOPPED) { var state = audioRenderer.state;
console.info('Renderer stopped'); if (state != audio.AudioState.STATE_RUNNING || state != audio.AudioState.STATE_PAUSED) {
} else { console.info('Renderer is not running or paused');
console.error('Renderer stop failed'); return;
} }
await audioRenderer.stop();
state = audioRenderer.state;
if (state == audio.AudioState.STATE_STOPPED) {
console.info('Renderer stopped');
} else {
console.error('Renderer stop failed');
}
} }
``` ```
...@@ -220,22 +218,20 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可 ...@@ -220,22 +218,20 @@ AudioRenderer提供了渲染音频文件和控制播放的接口，开发者可
AudioRenderer会使用大量的系统资源，所以请确保完成相关任务后，进行资源释放。 AudioRenderer会使用大量的系统资源，所以请确保完成相关任务后，进行资源释放。
```js ```js
async function releaseRenderer() { async function releaseRenderer() {
if (state_ == RELEASED || state_ == NEW) { if (state_ == RELEASED || state_ == NEW) {
console.info('Resourced already released'); console.info('Resourced already released');
return; return;
} }
await audioRenderer.release(); await audioRenderer.release();
state = audioRenderer.state;
if (state == STATE_RELEASED) {
console.info('Renderer released');
} else {
console.info('Renderer release failed');
}
}
```
state = audioRenderer.state;
\ No newline at end of file if (state == STATE_RELEASED) {
console.info('Renderer released');
} else {
console.info('Renderer release failed');
}
}
```
\ No newline at end of file
zh-cn/application-dev/media/camera.md
浏览文件 @ c0c4b527
...@@ -54,16 +54,16 @@ await cameraManager.getCameras((err, cameras) => { ...@@ -54,16 +54,16 @@ await cameraManager.getCameras((err, cameras) => {
cameraArray = cameras cameraArray = cameras
}) })
for(let cameraIndex = 0; cameraIndex < cameraArray.length; cameraIndex) { for(let cameraIndex = 0; cameraIndex < cameraArray.length; cameraIndex) {
console.log('cameraId : ' + cameraArray[cameraIndex].cameraId) //获取相机ID console.log('cameraId : ' + cameraArray[cameraIndex].cameraId) //获取相机ID
console.log('cameraPosition : ' + cameraArray[cameraIndex].cameraPosition) //获取相机位置 console.log('cameraPosition : ' + cameraArray[cameraIndex].cameraPosition) //获取相机位置
console.log('cameraType : ' + cameraArray[cameraIndex].cameraType) //获取相机类型 console.log('cameraType : ' + cameraArray[cameraIndex].cameraType) //获取相机类型
console.log('connectionType : ' + cameraArray[cameraIndex].connectionType) //获取相机连接类型 console.log('connectionType : ' + cameraArray[cameraIndex].connectionType) //获取相机连接类型
} }
//创建相机输入流 //创建相机输入流
let cameraInput let cameraInput
await cameraManager.createCameraInput(cameraArray[0].cameraId).then((input) => { await cameraManager.createCameraInput(cameraArray[0].cameraId).then((input) => {
console.log('Promise returned with the CameraInput instance'); console.log('Promise returned with the CameraInput instance');
cameraInput = input cameraInput = input
}) })
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或