cvVibrate

概述

振动反馈、震动反馈、短振动、短震动,安卓可以指定振动时长,封装类似IOS触发3dtouch振动反馈,提供IOS下的Peek、Pop、三次连续振动(支持3DTouch的IOS设备都可以使用)等振动反馈,安卓封装振动与IOS相似时长真干反馈,支持自定义时长震动和暂停振动。**

实例widget下载地址

Peek

Peek振动

Peek(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.Peek(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

Pop

Pop振动

Pop(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.Pop(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

Three

三次连续振动

Three(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.Three(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

Long

长振动

Long(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.Long(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

Custom

自定义时长振动模式(仅安卓支持自定义时长振动,IOS是支持自定义时间间歇振动

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

params

time:

  • 类型: 数字类型;time 有效期,单位(毫秒)
  • 描述:(必填项)振动的总时长,到时间后停止振动。

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.Custom({time:2000},function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

stopVibrate

停止振动

stopVibrate(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.stopVibrate(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

Android系统,可提供的1.0.0及更高版本 iOS系统,可提供的1.0.1及更高版本

voiceVibrate

播放系统默认信息铃声并振动(系统设置静音时不播放铃声)

voiceVibrate(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.voiceVibrate(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

ringTone

根据系统SoundID选择播放手机铃声(系统设置静音时不播放铃声)

ringTone(params,callback(ret, err))

params

SoundID

  • 类型: 数字类型;SoundID IOS取值参考网站:http://iphonedevwiki.net/index.php/AudioServices 安卓取值:1(消息铃声)2(电话铃声)3(闹钟铃声)任意数字(不通品牌手机存在差异)
  • 描述:(必填项)系统铃声id。

time:

  • 类型: 数字类型;time 有效期,单位(毫秒)
  • 描述:(必填项)铃声播放振动的总时长,到时间后停止振动。

duration:

  • 类型: 数字类型;duration 有效期,单位(毫秒)
  • 描述:(选填项)铃声循环间隔,调节循环次数。(time存在时必填项)

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.ringTone(function(
  {
    SoundID: 1,
    time: 7000,
    duration: 1000
  }
,ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

stopVibrate

停止铃声和振动(不能停止Custom、Long等纯震动接口)

stopRingTone(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true      //布尔型;true||false,当前模式振动是否触发成功。
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: -1     //数字类型;
                //错误码:
                //-1(未知错误)
}

示例代码

var cvVibrate = api.require('cvVibrate');
cvVibrate.stopRingTone(function(ret, err){
    if(ret.status){
        alert("触发成功");
    }else{
        alert('触发失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

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