volume

initVolume

getVolume

setVolume

setSpeakerphoneOn

addVolumeEvent

removeVolumeEvent

论坛示例

为帮助用户更好更快的使用插件，论坛维护了一个示例，示例中包含示例代码供您参考。

概述

本插件封装了原生代码调节app系统媒体音量功能（备注：由于iOS系统的特有情况，调节音量会自动弹出系统的音量图标）。

固件要求

Android：4.0及以上 iOS：8.0及以上

插件接口

initVolume

初始化媒体音量控制器

initVolume({params},callback(ret))

params

isShowSystemUI：

  • 类型：布尔型
  • 描述：（可选项）是否显示系统自带的音量控制条(显示:true 隐藏:false)
  • 默认值：false

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true
}

示例代码

var obj = api.require('volume');
obj.initVolume(function(ret) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android、iOS系统

getVolume

获取当前媒体音量

getVolume(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,
    volume : 90 //当前音量0-100 (由于安卓的maxVolume值不是100，所以这个值出来的和你设置的可能存在误差)
}

示例代码

var obj = api.require('volume');
obj.getVolume(function(ret) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android、iOS系统

setVolume

设置媒体音量

setVolume({params}, callback(ret))

params

volume：

  • 类型：数字型
  • 描述：（可选项）0-100
  • 默认值：0

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true
}

示例代码

var obj = api.require('volume');
obj.setVolume({
    volume : 50
},function(ret) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android、iOS系统

setSpeakerphoneOn

扬声器与听筒切换

setSpeakerphoneOn(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true
}

示例代码

var obj = api.require('volume');
obj.setSpeakerphoneOn(function(ret) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android、iOS系统

addVolumeEvent

监听手机物理音量按键事件

addVolumeEvent(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,
    evenType : 'volumeDown',//安卓音量增大事件:volumeUp
                       //安卓音量减少事件:volumeDown
                       //iOS音量改变事件:volumeChange
}

示例代码

var obj = api.require('volume');
obj.addVolumeEvent(function(ret) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android、iOS系统

removeVolumeEvent

移除监听手机物理音量按键事件

removeVolumeEvent(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true
}

示例代码

var obj = api.require('volume');
obj.removeVolumeEvent(function(ret) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

Android、iOS系统

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18