vibration

概述

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

是否仍需要帮助? 请保持联络!
最后更新于 2024/12/2