device


device模块管理设备信息,用于获取手机设备的相关信息,如IMEI、IMSI、型号、厂商等。通过rd.device获取设备信息管理对象。

属性:

  • imei : 设备的国际移动设备身份码,Android不支持6.0版本
  • imsi : 设备的国际移动用户识别码,Android不支持6.0版本
  • model : 设备的型号
  • vendor : 设备的生产厂商
  • uuid : 设备的唯一标识

方法:

  • dial : 拨打电话
  • beep : 启动或继续播放蜂鸣声,iOS不支持继续播放
  • pauseBeep : 暂停蜂鸣声,不支持iOS
  • stopBeep : 停止蜂鸣声,不支持iOS
  • vibrate : 设备振动
  • setWakelock : 设置应用是否保持唤醒(屏幕常亮)状态
  • isWakelock : 获取程序是否一直保持唤醒(屏幕常亮)状态
  • setVolume : 设置设备的系统音量
  • getVolume : 获取设备的系统音量
  • getIMEI :获取设备的国际移动设备身份码,Android 6.0新增接口,不支持iOS
  • getIMSI :获取设备的国际移动用户识别码,Android 6.0新增接口,不支持iOS

imei


设备的国际移动设备身份码

var imei = rd.device.imei;
说明:

只读属性,调用此属性获取设备的国际移动设备身份码。 如果设备不支持则返回空字符串。iOS不支持。

返回值:
  • String 类型

imsi


设备的国际移动用户识别码

var imsi = rd.device.imsi;
说明:

只读属性,获取设备上插入SIM的国际移动设备身份码。 如果设备支持多卡模式则返回所有SIM身份码。 如果设备不支持或没有插入SIM卡则返回空数组。不支持iOS.

返回值:
  • Array 字符串数组类型

model


设备的型号

var model = rd.device.model;
说明:

只读属性,此属性获取设备的型号信息。 如果设备不支持则返回空字符串。

返回值:
  • String 类型

vendor


设备的生产厂商

var vendor = rd.device.vendor;
说明:

只读属性,调用此属性获取设备的型号信息。 如果设备不支持则返回空字符串。

返回值:
  • String 类型

uuid


设备的唯一标识

var UUID = rd.device.uuid;
说明:

只读属性,调用此属性获取设备的唯一标识号,根据包名随机生成的设备标识号。注意:在设备重置后会重新生成。

返回值:
  • String 类型

dial


拨打电话

rd.device.dial( number, confirm );
说明:

调用系统程序拨打电话。

返回值:

无返回值

参数:
  • number: ( String ) 必选 电话号码
  • confirm: ( Boolean ) 可选 是否弹出确认对话框,默认false
返回值:

无返回值

示例:
rd.device.dial('17701326856', false);

beep


发出蜂鸣声

rd.device.beep( times );
说明:

调用此方法使得设备发出蜂鸣声或继续播放暂停后的蜂鸣声(iOS不支持继续播放)。

参数:
  • times: ( Number ) 可选 蜂鸣声重复的次数,默认发出一次蜂鸣声,ios不支持
返回值:

无返回值

示例:
rd.device.beep( 3 );
pauseBeep

暂停蜂鸣声

rd.device.pauseBeep();
说明:

调用此方法暂停蜂鸣声(iOS不支持)

参数:

返回值:

无返回值

示例:
rd.device.pauseBeep();
stopBeep

停止蜂鸣声

rd.device.stopBeep();
说明:

调用此方法停止蜂鸣声(iOS不支持)

参数:

返回值:

无返回值

示例:
rd.device.stopBeep();
vibrate

设备振动

rd.device.vibrate( milliseconds );
说明:

调用此方法使得设备振动。

参数:
  • milliseconds: ( Number ) 必选 设备振动持续的时间,单位为ms,默认为500ms。ios不支持
返回值:

无返回值

示例:
rd.device.vibrate( 500 );

setWakelock


设置应用是否保持唤醒(屏幕常亮)状态

rd.device.setWakelock( lock );
说明:

调用此方法设置应用是否一直保持唤醒状态,保持唤醒状态将会导致程序屏幕常亮、系统不会自动锁屏,从而导致消耗更多的电量。若未设置一直保持唤醒状态则会根据系统设置自动锁定屏幕。

参数:
  • lock: ( Boolean ) 必选 是否设置程序一直保持唤醒状态 可取值true或false,true表示设定程序一直保持唤醒状态,false表示关闭程序一直保持唤醒状态。程序退出后将恢复默认状态,默认为关闭程序保持唤醒状态。
返回值:

无返回值

示例:
rd.device.setWakelock( true );

isWakelock


获取程序是否一直保持唤醒(屏幕常亮)状态

var state = rd.device.isWakelock();
说明:

调用此方法获取程序是否一致保持唤醒状态。

参数:

返回值:
  • Boolean : 返回true表示程序已设置为一直保持唤醒状态,返回false表示程序未设置为一直保持唤醒状态。

setVolume


设置设备的系统音量

rd.device.setVolume( volume );
说明:

调用此方法调节设备的系统音量。Android设置音量后对所有项的音量生效,如通话音量、系统音量、铃声音量、音乐音量、提示声音音量。iOS设置音量后仅对媒体声音有效。

参数:
  • volume: ( Number ) 必选 设备的系统音量值 取值范围为0到1,0表示静音,1表示最大音量值。设置设备音量后对所有程序生效,退出程序系统仍然保持最后设定的音量值。
返回值:

无返回值

示例:
rd.device.setVolume( 0.8 );

getVolume


获取设备的系统音量

var volum = rd.device.getVolume();
说明:

系统音量值范围为0到1,0表示静音,1表示最大音量值。

参数:

返回值:
  • Number : 系统的音量值范围为0到1
示例:
rd.device.getVolume();

getIMEI


设备的型号

var imei = rd.device.getIMEI();
说明:

获取设备的国际移动设备身份码,Android 6.0及以上版本才有效,不支持iOS。

返回值:
  • String 类型

getIMSI


设备的型号

var imsi = rd.device.getIMSI();
说明:

获取设备的国际移动用户识别码,如果设备支持多卡模式则返回所有SIM身份码。如果设备不支持或没有插入SIM卡则返回空数组,Android 6.0及以上版本才有效,不支持iOS。

返回值:
  • String 类型