Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e66d1fb5
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看板
体验新版 GitCode,发现更多精彩内容 >>
提交
e66d1fb5
编写于
11月 02, 2022
作者:
J
jiao_yanlin
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Supplement and optimization of development guide
Signed-off-by:
N
jiao_yanlin
<
jiaoyanlin@huawei.com
>
上级
10e94e22
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
126 addition
and
0 deletion
+126
-0
zh-cn/application-dev/media/audio-volume-manager.md
zh-cn/application-dev/media/audio-volume-manager.md
+126
-0
zh-cn/application-dev/media/figures/zh-ch_image_audio_volume_manager.png
...on-dev/media/figures/zh-ch_image_audio_volume_manager.png
+0
-0
未找到文件。
zh-cn/application-dev/media/audio-volume-manager.md
0 → 100644
浏览文件 @
e66d1fb5
# 音量管理开发指导
## 简介
AudioVolumeManager提供了音量管理的方法。开发者可以通过本指导了解应用如何通过AudioVolumeManager获取指定流音量信息、监听铃声模式变化、设置麦克风静音等。
## 运作机制
该模块提供了音量管理模块常用接口
**图1**
音量管理常用接口
![
zh-ch_image_audio_volume_manager
](
figures/zh-ch_image_audio_volume_manager.png
)
**说明:**
AudioVolumeManager包含音量变化监听处理和音频音量组管理相关(AudioVolumeGroupManager),开发者调用AudioVolumeGroupManager的相关方法,需要先调用getVolumeGroupManager方法创建AudioVolumeGroupManager实例,从而调用对应的接口实现相应的功能,主要接口有:获取指定流的音量、设置麦克风静音、监听麦克风状态变化等。更多介绍请参考
[
API参考文档
](
../reference/apis/js-apis-audio.md
)
。
## 约束与限制
开发者在进行麦克风管理开发前,需要先对所开发的应用配置麦克风权限(ohos.permission.MICROPHONE),如果要设置麦克风状态,则需要配置音频管理配置权限(ohos.permission.MANAGE_AUDIO_CONFIG),需注意该权限为系统级别权限。权限配置相关内容可参考:
[
访问控制授权申请指导
](
../security/accesstoken-guidelines.md
)
## 开发指导
详细API含义可参考:
[
音量管理API文档AudioVolumeManager
](
../reference/apis/js-apis-audio.md#audiovolumemanager9
)
1.
创建AudioVolumeGroupManager实例。
在使用AudioVolumeGroupManager的API前,需要使用getVolumeGroupManager创建一个AudioStreamManager实例。
```
js
import
audio
from
'
@ohos.multimedia.audio
'
;
async
loadVolumeGroupManager
()
{
const
groupid
=
audio
.
DEFAULT_VOLUME_GROUP_ID
;
var
audioVolumeGroupManager
=
await
audio
.
getAudioManager
().
getVolumeManager
().
getVolumeGroupManager
(
groupid
);
console
.
error
(
'
audioVolumeGroupManager create success.
'
);
}
```
2.
(可选)获取音量信息、铃声模式。
如果开发者需要获取指定音频流的音量信息(铃声、语音电话、媒体、语音助手等),或者获取当前设备是静音、震动、响铃模式,可参考并调用以下接口。更多事件请参考
[
API参考文档
](
../reference/apis/js-apis-audio.md
)
。
```
js
import
audio
from
'
@ohos.multimedia.audio
'
;
async
loadVolumeGroupManager
()
{
const
groupid
=
audio
.
DEFAULT_VOLUME_GROUP_ID
;
var
audioVolumeGroupManager
=
await
audio
.
getAudioManager
().
getVolumeManager
().
getVolumeGroupManager
(
groupid
);
console
.
error
(
'
audioVolumeGroupManager create success.
'
);
}
//获取指定流的当前音量(通常范围为1 ~ 15)
async
getVolume
()
{
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
getVolume
(
audio
.
AudioVolumeType
.
MEDIA
).
then
((
value
)
=>
{
console
.
error
(
`getVolume-------------success and volume is:
${
value
}
.`
);
});
}
//获取指定流的最小音量
async
getMinVolume
()
{
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
getMinVolume
(
audio
.
AudioVolumeType
.
MEDIA
).
then
((
value
)
=>
{
console
.
error
(
`getMinVolume-------------success and volume is:
${
value
}
.`
);
});
}
//获取指定流的最大音量
async
getMaxVolume
()
{
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
getMaxVolume
(
audio
.
AudioVolumeType
.
MEDIA
).
then
((
value
)
=>
{
console
.
error
(
`getMaxVolume-------------success and volume is:
${
value
}
.`
);
});
}
//获取当前铃声模式: 静音(0)| 震动(1) | 响铃(2)
async
getRingerMode
()
{
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
getRingerMode
().
then
((
value
)
=>
{
console
.
error
(
`getRingerMode-----success and RingerMode is:
${
value
}
.`
);
});
}
```
3.
(可选)查询、设置、监听麦克风状态。
如果开发者需要获取、设置麦克风状态,或者监听麦克风状态变化等信息,可参考并调用以下接口。
```
js
import
audio
from
'
@ohos.multimedia.audio
'
;
async
loadVolumeGroupManager
()
{
const
groupid
=
audio
.
DEFAULT_VOLUME_GROUP_ID
;
var
audioVolumeGroupManager
=
await
audio
.
getAudioManager
().
getVolumeManager
().
getVolumeGroupManager
(
groupid
);
console
.
error
(
'
audioVolumeGroupManager create success.
'
);
}
async
on
()
{
//监听麦克风状态变化
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
audioVolumeGroupManager
.
on
(
'
micStateChange
'
,
(
micStateChange
)
=>
{
console
.
error
(
`Current microphone status is:
${
micStateChange
.
mute
}
`
);
});
}
async
isMicrophoneMute
()
{
//查询麦克风是否静音
await
audioVolumeGroupManager
.
audioVolumeGroupManager
.
isMicrophoneMute
().
then
((
value
)
=>
{
console
.
error
(
`isMicrophoneMute is:
${
value
}
.`
);
});
}
async
setMicrophoneMuteTrue
()
{
//设置麦克风静音
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
audioVolumeGroupManager
.
setMicrophoneMute
(
true
).
then
(()
=>
{
console
.
error
(
'
setMicrophoneMute to mute.
'
);
});
}
async
setMicrophoneMuteFalse
()
{
//取消麦克风静音
await
loadVolumeGroupManager
();
await
audioVolumeGroupManager
.
audioVolumeGroupManager
.
setMicrophoneMute
(
false
).
then
(()
=>
{
console
.
error
(
'
setMicrophoneMute to not mute.
'
);
});
}
async
test
(){
//综合调用:先设置监听,然后查询麦克风状态,设置麦克风静音后再查询状态,最后取消麦克风静音。
await
on
();
await
isMicrophoneMute
();
await
setMicrophoneMuteTrue
();
await
isMicrophoneMute
();
await
setMicrophoneMuteFalse
();
}
```
zh-cn/application-dev/media/figures/zh-ch_image_audio_volume_manager.png
0 → 100644
浏览文件 @
e66d1fb5
77.4 KB
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录