JavaScript轻应用高级组件

 

1、前言

除了基础的功能组件外,JavaScript轻应用还提供了阿里云智能物联网平台连接以及语音播报等能力,具体介绍如下。

 

2、iot - 阿里云IoT平台连接组件

示例代码

/* iot - 阿里云IoT连接平台连接组件示例,产品功能定义:

 * [功能类型] ------ [功能名称] ------ [标志符] ------ [数据类型]

 *   属性            主灯开关        LightSwitch      bool (0-关闭 1-开启)

 *   服务            开关翻转     ToggleLightSwitch   -

 *   事件            故障上报           Error         参数标志符:ErrorCode

 * */



var iot = require('iot');



var productKey = '<product-key>';

var deviceName = '<device-name>';

var deviceSecret = '<device-secret>';


var lightSwitch = 0;


var device = iot.device({

    productKey: productKey,

    deviceName: deviceName,

    deviceSecret: deviceSecret,

    region: 'cn-shanghai',

    success: function () {

        console.log('connect success');

        onConnect();

    },

    fail: function () {

        console.log('connect failed');

    }

});


function onConnect() {

    setInterval(function () {

        /** post properties */

        lightSwitch = 1 - lightSwitch;

        device.postProps({

            payload: {

                LightSwitch: lightSwitch

            },

            success: function () {

                console.log('postProps success');

            },

            fail: function () {

                console.log('postProps failed');

            }

        });

        /** post events */

        device.postEvent({

            id: 'Error',

            params: {

                ErrorCode: 0

            },

            success: function () {

                console.log('postEvent success');



            },

            fail: function () {

                console.log('postEvent failed');

            }

        });

    }, 3000);

}



device.on('connect', function () {

    console.log('(re)connected');

});



/* 网络断开事件 */

device.on('disconnect', function () {

    console.log('disconnect ');

});



/* 关闭连接事件 */

device.on('close', function () {

    console.log('iot client just closed');

});



/* 发生错误事件 */

device.on('error', function (err) {

    console.log('error ' + err);

});



/* 云端设置属性事件 */

device.on('props', function (payload) {

    console.log('cloud req data is ', payload);

    console.log('LightSwitch ', payload.LightSwitch ? 'ON' : 'OFF');

});



/* 云端下发服务事件 */

device.on('service', function (id, payload) {

    console.log('received cloud serviceid is ' + id);

    console.log('received cloud req_data is ' + payload);

});

var iot = require('iot');



var productKey = '<product-key>';

var deviceName = '<device-name>';

var deviceSecret = '<device-secret>';



/* 设备签名 */

iot.sign({

    productKey: productKey,

    deviceName: deviceName,

    deviceSecret: deviceSecret,

    region: 'cn-shanghai',

    success: function (params) {

        console.log('sign success');

        console.log(params);

    },

    fail: function () {

        console.log('sign failed');

    }

});

 

device(Object option)

创建 iot 实例,同时会开始尝试连接阿里云IoT平台。iot实例默认开启TLS加密。

入参

属性

类型

必填

描述

productKey

String

设备的prodctKey

deviceName

String

设备的deviceName

deviceSecret

String

设备的deviceSecret

region

String

阿里云region,默认值:cn-shanghai。阿里云region详细说明见阿里云物联网平台 - 地域和可用区

success

Function

连接成功时的回调函数

fail

Function

连接失败的回调函数

返回

 

sign(Object option)

进行设备签名。本接口相对独立,当 iot JSAPI 无法满足要求时,可以使用本接口进行设备认证,然后使用 mqtt JSAPI 接入阿里云物联网平台。设备签名请参考 设备接入Link SDK - 设备签名

入参

属性

类型

必填

描述

productKey

String

设备的prodctKey

deviceName

String

设备的deviceName

deviceSecret

String

设备的deviceSecret

region

String

阿里云region,默认值:cn-shanghai。阿里云region详细说明见阿里云物联网平台 - 地域和可用区

success

Function

认证成功的回调函数

fail

Function

认证失败的回调函数

success回调函数参数

Object类型,其属性有:

 

属性

类型

描述

host

String

可以连接的MQTT服务器域名地址, 根据入参 region 自动计算

port

Number

可以连接的MQTT服务器端口号, 根据标准MQTT协议一般是 1883 或者 443

username

String

连接MQTT服务器时将要使用的用户名

password

String

连接MQTT服务器时将要使用的密码, 和用户名一一对应

clientid

String

连接MQTT服务器时标识设备的自定义ID, 服务器对此不做校验, 鉴权通过 username password 进行

fail回调函数参数

属性

类型

描述

error

String

错误信息

 

iot 实例

事件

当iot client 连接到iot平台时,触发connect事件。断开重连时也会触发该事件。

当连接断开时,触发'disconnect'事件。

当iot client 关闭时,触发close事件。

当iot云端下发属性设置时,触发props事件。

当iot云端调用设备service时,触发service事件。

当设备跟iot平台通信过程中遇到错误时,触发error事件。

方法

上报属性。

上报事件。

关闭iot实例。

注册iot事件回调函数。

 

事件:'connect'

当iot client 连接到iot平台时,触发'connect'事件。断开重连时也会触发该事件。

 

事件:'disconnect'

当连接断开时,触发'disconnect'事件。三元组错误、三元组重复上线、服务端断开连接、主动断开连接、网络发生异常等都会触发该事件。该事件触发时,会自动尝试重连。

 

事件:'close'

当iot client 关闭时,触发'close'事件。

 

事件:'props'

当iot云端下发属性设置时,触发'props'事件。

回调函数参数有:

属性

类型

描述

payload

Object

服务端设置设备属性的内容

 

事件:'service'

当iot云端调用设备service时,触发'service'事件。

回调函数参数有:

属性

类型

描述

id

String

服务标志符,详细请参考什么是物的模型

payload

Object

服务端设置设备属性的内容

 

事件:'error'

当设备跟iot平台通信过程中遇到错误时,触发'error'事件。'error'事件的回调函数参数有:

 

属性

类型

描述

error

String

错误信息

 

iot.postProps(Object options)

上报设备属性。

入参

Object类型,其属性有:

 

属性

类型

必填

描述

payload

Object

设备定义的属性参数。详细请参考什么是物的模型

success

Function

上报设备属性成功的回调函数

fail

Function

上报设备属性失败的回调函数

 

iot.postEvent(Object options)

上报设备的事件。

入参

Object类型,其属性有:

属性

类型

必填

描述

id

String

事件标志符,详细请参考什么是物的模型

params

Object

要上报的事件参数

success

Function

上报设备事件成功的回调函数,其函数参数参见下面说明

fail

Function

上报设备事件失败的回调函数

success回调函数参数:

属性

类型

描述

res

String

服务端reply的消息内容

 

iot.close()

关闭IoT实例。

 

iot.on(String event, Function callback)

监听事件。

入参

属性

类型

必填

描述

event

String

注册的事件名称

callback

Function

监听事件的回调函数

 

3、audioplayer - 音频播放组件

示例代码

var audioplayer = require('audioplayer');


var audioplayerState = ['stop', 'paused', 'playing', 'listplay_begin', 'listplay_end', 'error'];


audioplayer.on('stateChange', function(state) {

  console.log('audioplayer state: ' + audioplayerState[state]);

});


audioplayer.setVolume(60);


audioplayer.play("/test.mp3");


setTimeout(function() {

    console.log("playback pause");

    audioplayer.pause();

    var position = audioplayer.getPosition();

    var duration = audioplayer.getDuration();

    console.log('playback progress: ' + position + '/' + duration);

}, 5000)


setTimeout(function() {

    console.log("playback resume");

    audioplayer.resume();

}, 10000)


setTimeout(function() {

    console.log("playback from 1s");

    audioplayer.seekto(1);

}, 15000)


setTimeout(function() {

    var position = audioplayer.getPosition();

    var duration = audioplayer.getDuration();

    console.log('playback progress: ' + position + '/' + duration);

}, 16000)


setTimeout(function() {

    console.log("playback stop");

    audioplayer.stop();

}, 30000)

 

play(String path)

开始播放指定的音频。

入参

属性

类型

必填

描述

path

String

本地音频文件绝对路径或者音频url。

支持的音频格式:

mp3、wav

返回值

  • Number类型,0:成功,其他:失败。

 

pause()

暂停播放。

入参

  • 无。

返回值

  • Number类型,0:成功,其他:失败。

 

resume()

继续播放。

入参

  • 无。

返回值

  • Number类型,0:成功,其他:失败。

 

stop()

停止播放。

入参

  • 无。

返回值

  • Number类型,0:成功,其他:失败

 

listPlay(Array paths)

依次播放列表中的音频文件。

入参

  • 音频文件绝对路径数组。

返回值

  • Number类型,0:成功,其他:失败。

 

setVolume(Number volume)

设置播放音量。

入参

属性

类型

必填

描述

volume

Number

音量大小,取值范围:0-100,默认:40

返回值

  • Number类型,0:成功,其他:失败。

 

getVolume()

获取当前音量。

入参

  • 无。

返回值

  • Number类型,当前音量大小。

 

getState()

获取当前播放器状态。

入参

  • 无。

返回值

播放器状态

属性

类型

描述

state

Number

音频播放器当前状态

0 - 播放停止

1 - 播放暂停

2 - 播放开始

3 - 列表播放开始

4 - 列表播放结束

5 - 播放器错误

 

seekto(Number seconds)

从指定位置处开始播放。

入参

属性

类型

必填

描述

seconds

Number

播放位置,单位:秒

返回值

  • Number类型,0:成功,其他:失败。

 

getPosition()

获取当前播放进度。

入参

  • 无。

返回值

  • Number类型,当前播放进度,单位:秒。

 

getDuration()

获取当前音频文件时长。

入参

  • 无。

返回值

  • Number类型,当前播放音频文件时长,单位:秒。
  •  

事件:'stateChange'

当播放器状态变化时,触发'stateChange'事件。

回调函数参数有:

属性

类型

描述

state

Number

音频播放器当前状态

0 - 播放停止

1 - 播放暂停

2 - 播放开始

3 - 列表播放开始

4 - 列表播放结束

5 - 播放器错误

 

开发者技术支持

如需更多技术支持,可加入钉钉开发者群,或者关注微信公众号

更多技术与解决方案介绍,请访问阿里云AIoT首页https://iot.aliyun.com/

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值