vibration

来自于：开发者立即使用

vibrate vibrates cancel

概述

vibration模块封装了安卓手机控制振动功能，使用此模块可实现对安卓手机控制振动或是连续振动。暂仅支持 android 平台。

vibrate

振动

vibrate({params},callback(ret, err))

params

time：

类型：数字
描述：数字的单位是毫秒，表示振动的时间

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

{
    status:    //true or false
}

err：

类型：JSON 对象

内部字段：

{
    msg:    //返回错误信息
}

示例代码

var vibration= api.require('vibration');
var param = {time: 3000};
vibration.vibrate(param, function (ret, err) {
    if (ret.status) {
        alert("振动已开启");
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify("错误信息：" + err.msg));
    }
});

补充说明

这种方法被Android官方在API26级别被废弃。

可用性

Android系统

可提供的1.0.0及更高版本

vibrates

连续振动

vibrates({params},callback(ret, err))

params

time：

类型：数组
描述：数字的单位是毫秒，表示打开或关闭振动器的一系列时间长度
说明：以毫秒为单位传递一组数字，这些数字是以毫秒为单位打开或关闭振动器的持续时间。第一个值表示在打开振动器之前要等待的毫秒数。下一个值表示在关闭之前保持振动器开启的毫秒数。后续值在以毫秒为单位的持续时间之间交替关闭振动器或打开振动器。

times：

类型：数字
描述：重复模式的索引
说明：若要重复该模式，请将索引传递到开始重复的模式数组，或-1以禁用重复（-1表示不重复执行，其他数字表示重复振动）

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

{
    status:    //true or false
}

err：

类型：JSON 对象

内部字段：

{
    msg:    //返回错误信息
}

示例代码

var vibration= api.require('vibration');
var param = {time: [0, 1000, 2000, 500, 2000, 500, 2000, 500], times: -1};
vibration.vibrates(param, function (ret, err) {
    if (ret.status) {
        alert("连续振动已开启");
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify("错误信息：" + err.msg));
    }
});

补充说明

这种方法被Android官方在API26级别被废弃且API大于等于21。

可用性

Android系统

可提供的1.0.0及更高版本

cancel

取消振动

cancel({params},callback(ret, err))

ret：

类型：JSON 对象

内部字段：

{
    status:    //true or false
}

err：

类型：JSON 对象

内部字段：

{
    msg:    //返回错误信息
}

示例代码

var vibration= api.require('vibration');
vibration.cancel(function (ret, err) {
    if (ret.status) {
        alert("振动已停止");
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify("错误信息：" + err.msg));
    }
});

补充说明

停止振动。

可用性

Android系统

可提供的1.0.0及更高版本