phoneListener

来自于:APICloud立即使用

概述

phoneListener 模块用于监听手机事件。支持的事件有: 耳机插拔,静音状态和通话状态。耳机插拔事件,在耳机插入或拔出时触发。静音事件,在用户开启或关闭手机静音时触发。 通话状态事件,在等待接听来电,接通或通话挂断时触发。

在 iOS 端,链接蓝牙耳机会被认为插入耳机。

headphonePluggedListener

监听耳机插拔事件

headphonePluggedListener({params}, callback(ret))

params

enable:

  • 类型:布尔
  • 描述:(可选项)是否启动耳机插拔事件监听
  • 默认:true

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    state: true        //布尔类型;true耳机插入,false耳机拔出

}

示例代码

var phoneListener = api.require('phoneListener');
phoneListener.headphonePluggedListener({
     enable : false
}, function(ret) {
     alert(JSON.stringify(ret));
});

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

ringerModeSilentListener

监听静音事件

ringerModeSilentListener({params}, callback(ret))

params

enable:

  • 类型:布尔
  • 描述:(可选项)是否启动静音事件监听
  • 默认:true

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true        //布尔类型;true 静音 
}

示例代码

var phoneListener = api.require('phoneListener');
phoneListener.ringerModeSilentListener({
        enable : false
}, function(ret) {
     alert(JSON.stringify(ret));
});

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

callStateListener

监听电话事件状态。注意:在 iOS 端本接口仅获取当前手机电话状态

callStateListener({params}, callback(ret))

params

enable:

  • 类型:布尔
  • 描述:(可选项)是否启动电话事件监听
  • 默认:true

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    state:'IDLE'     //字符串类型;IDLE 挂断;OFFHOOK 接通电话;RINGING 来电 DIALING 正在拨打电话 NOTHING
}

示例代码

var phoneListener = api.require('phoneListener');
phoneListener.callStateListener({
        enable : false
}, function(ret) {
     alert(JSON.stringify(ret));
});

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本