Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
14179ef3
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
14179ef3
编写于
9月 05, 2023
作者:
O
openharmony_ci
提交者:
Gitee
9月 05, 2023
浏览文件
操作
浏览文件
下载
差异文件
!23943 arkts格式整改
Merge pull request !23943 from zhangkai/monthly_20230815
上级
cd55136b
eeafc0c0
变更
2
展开全部
隐藏空白更改
内联
并排
Showing
2 changed file
with
802 addition
and
641 deletion
+802
-641
zh-cn/application-dev/media/audio-effect-management.md
zh-cn/application-dev/media/audio-effect-management.md
+27
-21
zh-cn/application-dev/reference/apis/js-apis-audio.md
zh-cn/application-dev/reference/apis/js-apis-audio.md
+775
-620
未找到文件。
zh-cn/application-dev/media/audio-effect-management.md
浏览文件 @
14179ef3
...
...
@@ -6,52 +6,55 @@
主要包括查询和设置当前音频播放流的音效模式,音效模式包括EFFECT_NONE关闭音效模式和EFFECT_DEFAULT默认音效模式。默认音效模式会根据创建音频流的ContentType和StreamUsage自动加载对应场景的音效。
### 获取播放实例
(示例代码仅支持JS格式)
### 获取播放实例
管理播放实例音效的接口是getAudioEffectMode()查询当前音频播放流的音效模式和setAudioEffectMode(mode: AudioEffectMode)设置当前音频播放流的音效模式,在使用之前,需要使用createAudioRenderer(options: AudioRendererOptions)先创建音频播放流AudioRenderer实例。
1.
步骤一:导入音频接口。
```
j
s
```
t
s
import
audio
from
'
@ohos.multimedia.audio
'
;
```
2.
步骤二:配置音频渲染参数并创建AudioRenderer实例,音频渲染参数的详细信息可以查看
[
AudioRendererOptions
](
../reference/apis/js-apis-audio.md#audiorendereroptions8
)
,创建AudioRenderer实例时会默认挂载EFFECT_DEFAULT模式音效。
```
js
let
audioStreamInfo
=
{
```
ts
import
audio
from
'
@ohos.multimedia.audio
'
;
import
{
BusinessError
}
from
'
@ohos.base
'
;
let
audioStreamInfo
:
audio
.
AudioStreamInfo
=
{
samplingRate
:
audio
.
AudioSamplingRate
.
SAMPLE_RATE_44100
,
channels
:
audio
.
AudioChannel
.
CHANNEL_1
,
sampleFormat
:
audio
.
AudioSampleFormat
.
SAMPLE_FORMAT_S16LE
,
encodingType
:
audio
.
AudioEncodingType
.
ENCODING_TYPE_RAW
};
let
audioRendererInfo
=
{
let
audioRendererInfo
:
audio
.
AudioRendererInfo
=
{
content
:
audio
.
ContentType
.
CONTENT_TYPE_SPEECH
,
usage
:
audio
.
StreamUsage
.
STREAM_USAGE_VOICE_COMMUNICATION
,
rendererFlags
:
0
};
let
audioRendererOptions
=
{
let
audioRendererOptions
:
audio
.
AudioRendererOptions
=
{
streamInfo
:
audioStreamInfo
,
rendererInfo
:
audioRendererInfo
};
audio
.
createAudioRenderer
(
audioRendererOptions
,
(
err
,
data
)
=>
{
audio
.
createAudioRenderer
(
audioRendererOptions
,
(
err
:
BusinessError
,
data
:
audio
.
AudioRenderer
)
=>
{
if
(
err
)
{
console
.
error
(
`Invoke createAudioRenderer failed, code is
${
err
.
code
}
, message is
${
err
.
message
}
`
);
return
;
}
else
{
console
.
info
(
'
Invoke createAudioRenderer succeeded.
'
);
let
audioRenderer
=
data
;
let
audioRenderer
:
audio
.
AudioRenderer
=
data
;
}
});
```
### 查询当前播放实例的音效模式
(示例代码仅支持JS格式)
### 查询当前播放实例的音效模式
```
js
audioRenderer
.
getAudioEffectMode
((
err
,
effectmode
)
=>
{
```
ts
import
{
BusinessError
}
from
'
@ohos.base
'
;
audioRenderer
.
getAudioEffectMode
((
err
:
BusinessError
,
effectmode
:
audio
.
AudioEffectMode
)
=>
{
if
(
err
)
{
console
.
error
(
`Failed to get params, code is
${
err
.
code
}
, message is
${
err
.
message
}
`
);
return
;
...
...
@@ -61,12 +64,13 @@
});
```
### 设置当前播放实例的音效模式
(示例代码仅支持JS格式)
### 设置当前播放实例的音效模式
关闭系统音效:
```
js
audioRenderer
.
setAudioEffectMode
(
audio
.
AudioEffectMode
.
EFFECT_NONE
,
(
err
)
=>
{
```
ts
import
{
BusinessError
}
from
'
@ohos.base
'
;
audioRenderer
.
setAudioEffectMode
(
audio
.
AudioEffectMode
.
EFFECT_NONE
,
(
err
:
BusinessError
)
=>
{
if
(
err
)
{
console
.
error
(
`Failed to set params, code is
${
err
.
code
}
, message is
${
err
.
message
}
`
);
return
;
...
...
@@ -78,8 +82,9 @@
开启系统音效默认模式:
```
js
audioRenderer
.
setAudioEffectMode
(
audio
.
AudioEffectMode
.
EFFECT_DEFAULT
,
(
err
)
=>
{
```
ts
import
{
BusinessError
}
from
'
@ohos.base
'
;
audioRenderer
.
setAudioEffectMode
(
audio
.
AudioEffectMode
.
EFFECT_DEFAULT
,
(
err
:
BusinessError
)
=>
{
if
(
err
)
{
console
.
error
(
`Failed to set params, code is
${
err
.
code
}
, message is
${
err
.
message
}
`
);
return
;
...
...
@@ -94,20 +99,21 @@
主要包括全局音效查询相应StreamUsage对应场景的音效模式。
对于播放音频类的应用,开发者需要关注该应用的音频流使用什么音效模式并做出相应的操作,比如音乐App播放时,应选择音乐场景下的模式。在使用查询接口前,开发者需要使用getStreamManager()创建一个AudioStreamManager音频流管理实例。
### 获取音频流管理接口
(示例代码仅支持JS格式)
### 获取音频流管理接口
1.
创建AudioStreamManager实例。在使用AudioStreamManager的API前,需要使用getStreamManager()创建一个AudioStreamManager实例。
```
j
s
```
t
s
import
audio
from
'
@ohos.multimedia.audio
'
;
let
audioManager
=
audio
.
getAudioManager
();
let
audioStreamManager
=
audioManager
.
getStreamManager
();
```
### 查询对应场景的音效模式
(示例代码仅支持JS格式)
### 查询对应场景的音效模式
```
js
audioStreamManager
.
getAudioEffectInfoArray
(
audio
.
StreamUsage
.
STREAM_USAGE_MEDIA
,
async
(
err
,
audioEffectInfoArray
)
=>
{
```
ts
import
{
BusinessError
}
from
'
@ohos.base
'
;
audioStreamManager
.
getAudioEffectInfoArray
(
audio
.
StreamUsage
.
STREAM_USAGE_MEDIA
,
async
(
err
:
BusinessError
,
audioEffectInfoArray
:
audio
.
AudioEffectInfoArray
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to get effect info array
'
);
return
;
...
...
zh-cn/application-dev/reference/apis/js-apis-audio.md
浏览文件 @
14179ef3
此差异已折叠。
点击以展开。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录