volume

论坛示例

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

概述

本插件封装了原生代码调节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/04/8