1、前言

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

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

示例代码

/* iot - 阿里云IoT连接平台连接组件示例，产品功能定义：
* [功能类型] ------ [功能名称] ------ [标志符] ------ [数据类型]
* 属性主灯开关 LightSwitch bool （0-关闭 1-开启）
* 服务开关翻转 ToggleLightSwitch -
* 事件故障上报 Error 参数标志符：ErrorCode
* */
var iot = require('iot');
var productKey = '';
var deviceName = '';
var deviceSecret = '';
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 = '';
var deviceName = '';
var deviceSecret = '';
/* 设备签名 */
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	否	连接失败的回调函数

iot 实例。

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 实例

事件

事件：'connect'

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

事件：'disconnect'

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

事件：'close'

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

事件：'props'

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

事件：'service'

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

事件：'error'

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

方法

iot.postProps(Object option)

上报属性。

iot.postEvent(Object option)

上报事件。

iot.close()

关闭iot实例。

iot.on(String event, Function callback)

注册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/

JavaScript轻应用高级组件

1、前言

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

device(Object option)

sign(Object option)

iot 实例

事件：'connect'

事件：'disconnect'

事件：'close'

事件：'props'

事件：'service'

事件：'error'

iot.postProps(Object options)

iot.postEvent(Object options)

iot.close()

iot.on(String event, Function callback)

3、audioplayer - 音频播放组件

play(String path)

pause()

resume()

stop()

listPlay(Array paths)

setVolume(Number volume)

getVolume()

getState()

seekto(Number seconds)

getPosition()

getDuration()

事件：'stateChange'

开发者技术支持