phoneListener

来自于：APICloud立即使用

Method

hasHeadset headphonePluggedListener ringerModeSilentListener callStateListener

概述

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

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

hasHeadset

判断当前设备是否有耳机插入

hasHeadset({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    hasHeadset: true  //布尔类型；当前设备是否有耳机插入
    isBluetooth:,        //布尔类型；是否是蓝牙耳机链接。当hasHeadset为true时有效。仅android有效
}

示例代码

var phoneListener = api.require('phoneListener');
phoneListener.hasHeadset(function(ret) {
     alert(JSON.stringify(ret));
});

可用性

iOS 系统，Android 系统

可提供的 1.0.1 及更高版本

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 及更高版本