系统音量 volume

导入模块

import volume from '@system.volume';

volume.getMediaValue(OBJECT)

获取当前多媒体音量。

• 参数

参数名	类型	必填	说明
success	Function	否	成功回调。
fail	Function	否	失败回调。
complete	Function	否	执行结束后的回调。

• 返回值

参数名	类型	说明
value	Number	系统媒体当前音量，共有 5 个音量档次 0, 0.4, 0.6, 0.8, 1。

• 示例

volume.getMediaValue({
	success: function(data) {
		console.log(`handling success: ${data.value}`);
	},
	fail: function(data, code) {
		console.log(`handling fail, code = ${code}`);
	}
});

volume.setMediaValue(OBJECT)

设置当前多媒体音量。

• 参数

参数名	类型	必填	说明
value	Number	是	设置的音量，共有 5 个音量档次 0, 0.4, 0.6, 0.8, 1。
success	Function	否	成功回调。
fail	Function	是	失败回调，连接蓝牙耳机加大音量时，会有弹窗提醒，点取消按钮会走 fail 回调，音量不会变化。
complete	Function	否	执行结束后的回调。

• 示例

volume.setMediaValue({
	value: 0.8,
	success: function() {
		console.log('handling success');
	},
	fail: function(data, code) {
		console.log(`handling fail, code = ${code}`);
	}
});