// 直接通过 window 访问
window.h5PanelSdk;

// 或webpack配置 externals
// webpack.config.js
module.exports = {
  externals: {
    'qcloud-iotexplorer-h5-panel-sdk': 'h5PanelSdk',
  },
};

API

sdk.controlDeviceData: (data, deviceId?: string) => Promise

data: any;
deviceId?: string; 可选，不传则使用当前设备deviceId

控制设备属性，如：

sdk.controlDeviceData({
    power_switch: 1
});

sdk.getDeviceDataHistory: (options) => Promise<{ RequestId: string, Context: string, FieldName: string, Listover: boolean, Results: any[] }>

options.FieldName: string; 查询的属性名称
options.MaxTime: number; 结束时间，毫秒时间戳
options.MinTime: number; 开始时间，毫秒时间戳
options.Context?: string; 翻页游标，首次查询时，可不带
options.Limit: number; 单页数据量

查询设备历史数据，具体用法参见: AppGetDeviceDataHistory 接口文档

sdk.getUserInfo()

拉取用户信息，具体用法参考 AppGetUser 接口文档

sdk.getProductInfo: ({ productId?: string }) => Promise

productId?: string; 可选，不传则使用当前产品 ProductId

拉取设备所属产品信息，具体用法参考 AppGetProducts 接口文档

sdk.getDeviceInfo: ({ deviceId?: string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId

拉取设备信息

sdk.getDeviceData: ({ deviceId?: string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId

拉取设备最新的属性，具体用法参考 AppGetDeviceData 接口文档

sdk.getDeviceStatus: ({ deviceId?: string }) => Promise<0 | 1>

deviceId?: string; 可选，不传则使用当前设备deviceId

拉取设备当前在线状态，0 - 离线，1 - 在线

sdk.deleteDevice: ({ deviceId?: string }) => Promise

删除设备，deviceId可选，不传则使用当前设备deviceId

sdk.getShareParams({ deviceId?: string }) => Promise

若该设备是分享设备，且分享方设置了自定义分享参数，则被分享人在接受分享后可通过调用该接口获取自定义分享参数

sdk.showDeviceDetail(options) => void;

options.deviceInfo?: Object; 展示详情的设备信息，不传则使用当前设备信息
options.labelWidth?: number; 设备详情的label宽度，默认 110，单位 px
options.marginTop?: number; 设备详情的上间距，默认 10，单位 px
options.shareParams?: object | string; 自定义分享参数
options.extendItems?: ExtendItemConfig[]; 自定义菜单配置
options.extendItems.labelIcon?: string; 展示在 label 前的 icon 地址
options.extendItems.label: string; 自定义菜单项的标题
options.extendItems.content?: string; 自定义菜单项的内容
options.extendItems.className?: string; 自定义菜单项的样式类名
options.extendItems.onClick?: () => any; 点击自定义菜单项后触发的回调
options.extendButtons?: ExtendButtonConfig[]; 自定义按钮配置
options.extendButtons.text: string; 自定义按钮文案
options.extendButtons.className?: string; 自定义按钮的样式类名
options.extendButtons.type?: 'danger' | 'primary' | 'warning'; 自定义按钮的风格
options.extendButtons.onClick: () => any; 自定义按钮点击后触发的回调
options.containerClassName?: string; 容器的样式名

在当前 H5 展示一个铺满全屏的设备详情视图，支持自定义拓展菜单项及按钮。

sdk.hideDeviceDetail() => void;

关闭设备详情视图

sdk.triggerVibrateShort(type?: 'heavy' | 'medium' | 'light'): Promise;

触发一次小程序的短震动，参考：https://developers.weixin.qq.com/miniprogram/dev/api/device/vibrate/wx.vibrateShort.html#%E5%8F%82%E6%95%B0

sdk.setTriggerVibrateShortFilter(filter: (property) => boolean, { vibrateShortType: 'heavy' | 'medium' | 'light' }) => void;

设置需要触发震动的物模型filter，当调用 controlDeviceData 时，会将变换的所有属性的物模型依次调用 filter 函数，当 filter 返回 true 时则会触发一次震动，如：

sdk.setTriggerVibrateShortFilter((property) => {
    // 当变更的属性的物模型类型是 bool 类型且 id = 'power_switch' 时，触发一次震动
    return property.define.type === 'bool' && property.id === 'power_switch';
}, { vibrateShortType: 'heavy' });

sdk.requestTokenApi: (action, data, options) => Promise

action: string 具体api名称，如：AppGetUser
data: object 接口调用参数
options: 参数参考 appDevSdk.requestApi 文档

sdk.checkFirmwareUpgrade: ({ deviceId?: string, silent?: boolean }) => Promise

deviceId?: string; 可选，不传则使用当前设备 deviceId
silent?: boolean; 静默检查固件升级，不弹出提示框，可选，默认为 false

FirmwareUpgradeInfo.CurrentVersion: string

设备当前固件版本

FirmwareUpgradeInfo.DstVersion: string

固件可升级版本

sdk.goDeviceDetailPage: (options) => void

options.reload?: boolean; 如果传了 reload=true，则进入详情页后会重新拉取一次该设备的数据
options.deviceId?: string; 可选，不传则使用当前设备deviceId
options.isShareDevice?: boolean; 可选，设备是否分享设备，不传则使用当前 sdk.isShareDevice
options.shareParams?: object | string; 可选，设备自定义分享参数

跳转到腾讯连连通用的产品详情页（小程序页面）

sdk.goFeedBackPage()

前往连连小程序反馈页面

sdk.goDeviceInfoPage: ({ deviceId?: string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId

前往设备信息页

sdk.goEditDeviceNamePage: ({ deviceId?: string, name?: string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId
name?: string; 可选，不传则使用当前设备的aliasName

前往修改设备名称页

sdk.goRoomSettingPage: ({ deviceId?: string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId

前往房间设置页

sdk.goShareDevicePage: ({ deviceId?: string, shareParams?: object | string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId
shareParams?: object | string; 可选，自定义分享参数

前往设备分享页

sdk.goFirmwareUpgradePage: ({ deviceId?: string }) => Promise

deviceId?: string; 可选，不传则使用当前设备deviceId

前往固件升级页

sdk.reloadAfterUnmount()

退出当前h5页面返回连连小程序后，让小程序主动刷新一次当前数据。

sdk.setShareConfig: ({ title, imgUrl }) => Promise

title: string 分享的标题
imgUrl?: string 分享图片的地址，默认会取当前页面截图

设置当前页面的分享内容，通过 wx.miniProgram.postMessage 向小程序推送分享信息，具体参考小程序页面分享文档

sdk.navBack: () => Promise

调用 wx.miniProgram.navigateBack 返回上一级页面

sdk.appDevSdk

应用开发 SDK 实例，H5面板sdk底层依赖应用开发小程序端SDK，更多调用能力请参考应用开发SDK文档

sdk.wx

微信 JS-SDK 实例，具体用法参考官方文档，使用前必须保证已经调用 sdk.wxSdkReady 方法

sdk.wxSdkReady: () => Promise

确保微信 jssdk 已注册完成，完成后会触发 resolve，该方法多次调用，若成功会返回缓存的 Promise 对象，如：

sdk.wxSdkReady().then(() => wx.miniProgram.navigateBack());

sdk.on(EventName, callback)

sdk.off(EventName, callback)

监听/解绑事件

事件

Event: 'wsClose'

code: number;
reason: string;

websocket 的 close 事件

Event: 'wsError'

error websocket的错误事件

websocket 的 error 事件

Event: 'wsControl'

deviceId 设备id
deviceData 设备数据

当 websocket 收到 control 指令后触发

Event: 'wsReport'

deviceId 设备id
deviceData 设备数据

当 websocket 收到 report 指令后触发

Event: 'wsStatusChange'

deviceId 设备id
deviceStatus: 0 | 1; 设备状态

当 websocket 收到 wsStatusChange 后触发

Event: 'appShow'

当 App.onShow 执行后触发

Event: 'appHide'

当 App.onHide 执行后触发

Event: 'pageShow'

当 Page.onShow 执行后触发

Event: 'pageHide'

当 Page.onHide 执行后触发

(Deprecated) sdk.onWsClose: (callback) => void;

已废弃，请用 sdk.on('wsClose', callback) 代替

callback: ({ code, reason }) => void;

当 websocket close 事件触发后执行回调

(Deprecated) sdk.onWsError: (callback) => void;

已废弃，请用 sdk.on('wsError', callback) 代替

callback: (error) => void;

当 websocket 触发 error 事件后触发回调

(Deprecated) sdk.onWsControl: (callback) => void;

已废弃，请用 sdk.on('wsControl', callback) 代替

callback: ({ deviceId, deviceData }) => void;

当 websocket 收到 control 指令后触发

(Deprecated) sdk.onWsReport: (callback) => void;

已废弃，请用 sdk.on('wsReport', callback) 代替

callback: ({ deviceId, deviceData }) => void;

当 websocket 收到 report 指令后触发

(Deprecated) sdk.onWsStatusChange: (callback) => void;

已废弃，请用 sdk.on('wsStatusChange', callback) 代替

callback: ({ deviceId, deviceStatus }) => void;

当 websocket 收到设备状态改变推送后触发回调

sdk.tips

tips模块，样式和风格与连连小程序一致

sdk.tips.show: (message, options) => Promise

options.type?: 'info' | 'danger' | 'loading' | 'success';
options.waitForHide?: boolean; 若为true，则 show 方法返回一个Promise，并且当关闭后才会触发 resolve
options.duration?: number; 展示提示的时间，单位毫秒，默认 1500
options.delayDuration?: number; 默认0，单位毫秒，提示会在该延时后展示
options.canClickClose?: boolean; 默认true，点击mask是否能够关闭提示
options.canBeReplace?: boolean; 默认false，为false时上一个提示未关闭前，再次调用 tips.show会被忽略

展示tips

sdk.tips.hide: () => Promise

关闭tips

sdk.tips.showLoading: (message, options) => Promise

封装后的 tips.show 方法，等价于：

this.show(message, {
    type: 'loading',
    canBeReplace: true,
    duration: 0,
    delayDuration: 200,
    canClickClose: false,
    ...options,
})

sdk.tips.hideLoading: () => Promise

关闭loading tips

注意，showLoading后必须主动调用hideLoading，否则tips永远不会消失

sdk.tips.showSuccess: (message, options) => Promise

封装后的 tips.show 方法，等价于：

this.show(message, { type: 'success', ...opts });

sdk.tips.showInfo: (message, options) => Promise

封装后的 tips.show 方法，等价于：

this.show(message, { type: 'info', ...options });

sdk.tips.showError: (error, options) => Promise

error: any; 可以为一个原生Error对象，可以为标准的api响应 { code, msg }，也可以为一个字符串。

会先标准化处理错误展示信息后展示tips，等价于：

sdk.tips.showModal: (options: ShowModalOptions) => Promise

ShowModalOptions.title?: string; 弹窗标题
ShowModalOptions.content? string; 弹窗内容
ShowModalOptions.showCancel?: boolean; 是否展示取消按钮，默认为 true
ShowModalOptions.cancelText?: string; 取消按钮文案，默认："取消"
ShowModalOptions.cancelColor?: string; 取消按钮颜色，默认："#6c7078"
ShowModalOptions.confirmText?: string; 确认按钮文案，默认："确定"
ShowModalOptions.confirmColor?: string; 确认按钮颜色，默认: "#0066ff"

展示一个弹窗，参数、功能、样式同小程序原生 showModal 基本一致，返回一个 Promise，为 true 代表用户点击确认，返回 false 表示用户点击取消。

sdk.tips.confirm: (title, content, options) => Promise

title?: string;
content?: string;
options?: ShowModalOptions;

基于 showModal 封装，用于向用户进行二次确认操作时使用，用法：

const isConfirm = await sdk.tips.confirm('确认删除该设备吗？')

if (isConfirm) {
    // do something
}

sdk.tips.alert: (content, options) => Promise

content?: string;
options?: ShowModalOptions;

基于 showModal 封装，用于向用户进行消息提示操作时使用，用法：

await sdk.tips.alert('该功能暂时无法使用，请稍后再试');

// do something else

sdk.offlineTip

设备离线提示组件，样式和风格与连连小程序一致

sdk.offlineTip.show: () => void;

展示离线提示

sdk.showOfflineTip: () => void;

用法同 sdk.offlineTip.show()

sdk.offlineTip.hide: () => void;

关闭离线提示

sdk.hideOfflineTip: () => void;

用法同 sdk.offlineTip.hide()

属性

sdk.deviceId: string

设备id，由 {productId}/{deviceName} 组成

sdk.productId: string

产品id

sdk.deviceName: string

设备名称

sdk.deviceInfo

设备信息，如：

{
    AliasName: "设备别名",
    CreateTime: 1583739344,
    DeviceId: "{productId}/{deviceName}",
    DeviceName: "{deviceName}",
    DeviceType: 0,
    FamilyId: "家庭ID",
    IconUrl: "设备ICON",
    ProductId: "{productId}",
    RoomId: "房间id",
    UpdateTime: 1583739344,
    UserID: "用户Id"
}

sdk.roomList

当前家庭的房间列表

sdk.roomName

当前设备的房间名称

sdk.dataTemplate

设备所在产品的物模型，如：

{
    "version": "1.0",
    "profile": {
        "ProductId": "xxxx",
        "CategoryId": "1"
    },
    "properties": [
        {
            "id": "int",
            "name": "int",
            "desc": "",
            "mode": "rw",
            "define": {
                "type": "int",
                "min": "0",
                "max": "100",
                "start": "0",
                "step": "1",
                "unit": ""
            },
            "required": false
        },
    ],
    "events": [],
    "actions": []
}

sdk.deviceStatus: number

设备在线状态，在线: 1，非在线: 0

sdk.deviceDisplayName: string

设备展示名称，会依次取：AliasName > productInfo.name > deviceName 来展示

sdk.isShareDevice: boolean

是否是分享设备

sdk.familyId: string

设备所在家庭id，如果是分享设备则无此值

sdk.roomId: string;

设备所在房间id，如果是分享设备则无此值

sdk.familyInfo

设备所在家庭详情，如果是分享设备则无此值

sdk.isFamilyOwner: boolean

用户是否是当前家庭的管理员

sdk.userInfo

用户信息，如：

{
    Avatar: "头像url",
    CountryCode: "国家代码",
    Email: "email",
    NickName: "昵称",
    PhoneNumber: "电话号码",
    UserID: "用户id"
}

蓝牙模块

由于h5中无法直接调用小程序蓝牙相关接口，sdk封装了特殊的蓝牙模块，通过一个单独的websocket通道打通了h5到小程序直接的蓝牙通信

名词介绍

介绍蓝牙模块中使用到的一些名词

serviceId

服务id，蓝牙服务的uuid，搜索设备时主要通过 serviceId 来过滤我们需要的设备。

deviceId

小程序api搜索出来的设备的标识，连接设备时主要通过 deviceId 来标识需要连接的设备

explorerDeviceId

物联网开发平台侧定义的设备ID，查询设备数据和上报设备数据时以该 id 作为设备标识。

BlueToothAdapter 蓝牙适配器

全局单例，实例上声明了蓝牙搜索、连接等方法

DeviceAdapter 设备适配器

真正用来连接设备以及跟设备进行通信的模块，每一个设备连接对应一个设备适配器实例，设备适配器会在连接设备后实例化，并在设备断开连接后销毁。

根据不同的 serviceId 来区别不同类型设备的适配器构造函数。

API

sdk.blueToothAdapter

sdk.addAdapter: (DeviceAdapter) => void;

添加一个设备适配器，默认无任何设备适配器，使用时需要根据具体设备情况创建一个设备适配器，并将其构造函数添加到蓝牙适配器中。

如：

class DemoDeviceAdapter extends DeviceAdapter {
	static serviceId = '0000FFF0-0000-1000-8000-00805F9B34CC';

	static deviceFilter(deviceInfo) {
		if (deviceInfo.advertisServiceUUIDs) {
			const matchedServiceId = deviceInfo.advertisServiceUUIDs.find(id => id === DemoDeviceAdapter.serviceId);

			if (matchedServiceId && deviceInfo.advertisData) {
				try {
					const macArr = deviceInfo.advertisData.slice(2);
					const mac = macArr.join(':');

					return {
						...deviceInfo,
						deviceName: mac,
						serviceId: matchedServiceId,
					}
				} catch (err) {
					console.error('parse mac error', err);
				}
			}
		}
	}

	handleBLEMessage(hex) {
        return {
          type: 'unknown',
          data: hex,
        };
	}
}

sdk.blueToothAdapter.addAdapter(DemoDeviceAdapter);

sdk.blueToothAdapter.init() => Promise;

初始化蓝牙模块，包括初始化蓝牙模块，打通小程序间蓝牙通信，注册全局回调等。返回一个带缓存的Promise，可重复调用，可在每次使用前调用

sdk.blueToothAdapter.startSearch(startSearchParams) => Promise

开始搜索蓝牙设备（将会调用 wx.startBluetoothDevicesDiscovery，比较耗费系统资源，务必在不需要搜索后调用 blueToothAdapter.stopSearch，如离开页面后）

该方法返回一个 Promise，注意务必要等待 Promise 响应 resolve 才代表操作指行成功。

startSearchParams.serviceId?: string;

startSearchParams.serviceIds?: string[];

指定需要搜索的serviceId，不传的话会使用当前支持的所有 DeviceAdapter 的 serviceId 来匹配。

startSearchParams.ignoreDeviceIds?: string[]

可选，需要过滤掉的 deviceId 列表（比如刚添加完的设备），搜索结果中将不会出现这些设备

startSearchParams.onSearch: (DeviceInfo[]) => void;

当搜索结果更新后调用，返回搜索到的设备列表

startSearchParams.onError: (Error) => void;

当搜索过程中发生错误后调用，触发后设备搜索将会中止

startSearchParams.timeout: number

可选，默认 20000，单位毫秒，超过多久没搜索到设备后将会触发超时错误

blueToothAdapter.stopSearch() => void;

停止搜索设备

[DEPRECATED] blueToothAdapter.searchDevice(searchDeviceParams) => Promise

[DEPRECATED] 请使用 blueToothAdapter.searchAndConnectDevice 方法代替 searchDevice + connectDevice 的流程

搜索蓝牙设备，并将在找到第一个满足条件的设备后 resolve，与 startSearch 的区别在于 searchDevice 在搜到第一个匹配设备后即会中止搜索。该方法常用于已经绑定过设备后，在连接设备时来定向搜索该设备。

startSearchParams.serviceId?: string;

startSearchParams.serviceIds?: string[];

指定需要搜索的serviceId，不传的话会使用当前支持的所有 DeviceAdapter 的 serviceId 来匹配。

searchDeviceParams.deviceName

指定需要搜索的设备 deviceName

searchDeviceParams.productId

指定需要搜索设备的 productId

searchDeviceParams.ignoreDeviceIds

指定需要忽略的设备 deviceId(微信搜索设备返回的deviceId，非explorerDeviceId)

searchDeviceParams.timeout

搜索超时时间，单位毫秒，默认 5000

searchDeviceParams.extendInfo

拓展参数，可以在搜索时调用 DeviceAdapter 实例的 deviceFilter 时拿到

searchDeviceParams.ignoreCache

忽略缓存，默认 false，开启缓存后已经连过的设备在本机默认不会再次搜索，而会尝试直连

searchDeviceParams.ignoreDeviceIds

同 startSearchParams.ignoreDeviceIds

blueToothAdapter.connectDevice(DeviceInfo, options?: { autoNotify?: boolean }) => Promise

options.autoNotify; 可选，默认为 true。指定为 true时，在连接设备后，会自动去拉取服务列表，以及主服务下的特征值列表，并会自动订阅第一个 notifyId 或 indicateId 特征值的 notify。若设备含有多个服务或多个 notify 特征值，请传 false，并自行通过 getBLEDeviceServices、getBLEDeviceCharacteristics、notifyBLECharacteristicValueChange等方法获取及订阅特征值。

连接指定设备，传入 searchDevice 或 startSearch 接口搜索出来的 DeviceInfo，连接成功后返回设备适配器

blueToothAdapter.getDeviceAdapter(deviceId) => deviceAdapter

根据 deviceId 查询对应的设备适配器实例，如果设备未连接或已断开，则返回空

事件

blueToothAdapter.on('adapterStateChange', ({ available, discovering }) => {})

当适配器状态变化时触发。

DeviceAdapter

设备适配器构造函数

DeviceAdapter.serviceId

子类在继承基类后需要设置该属性，代表该设备的主服务ID

DeviceAdapter.deviceFilter: (deviceInfo: DeviceInfo) => { deviceName: string, serviceId: string, ...deviceInfo }

子类在继承基类后需要实现该静态方法，在搜索蓝牙设备时会将每个搜出的设备信息传入该方法，如果判断是本产品的设备，则需在除入参deviceInfo之外返回设备唯一标识 deviceName 及 serviceId，否则返回空；

deviceAdapter

设备适配器

deviceAdapter.explorerDeviceId

getter，设备的 explorerDeviceId

deviceAdapter.isConnected

getter，设备当前是否连接状态

deviceAdapter.deviceId

getter，设备的 deviceId

deviceAdapter.serviceId

getter，设备的主服务ID，实际上既是挂在构造函数上的静态属性 DeviceAdapter.serviceId

deviceAdapter.originName

getter，设备的原始名称，即小程序接口搜索出来时的 name 字段

deviceAdapter.explorerDeviceId

getter，设备的 explorerDeviceId

deviceAdapter.disconnectDevice() => void

主动断开设备连接

deviceAdapter.getBLEDeviceServices() => Promise

拉取设备的服务列表

deviceAdapter.getBLEDeviceCharacteristics({ serviceId }) => Promise

serviceId?: string; 可选，默认为主服务id

拉取设备某服务的特征值列表，并会将特征值按照如下数据结构存放在 deviceAdapter实例上：

 deviceAdapter.characteristicsMap[serviceId] = {
    notifyIds: string[];
    indicateIds: string[];
    writeIds: string[];
    readIds: string[];
 }

deviceAdapter.readBLECharacteristicValue({ serviceId, characteristicId });

serviceId?: string; 可选，默认为主服务id
characteristicId: string; 需要读取的特征值id，默认会取主服务下的第一个read特征值

接口读取到的信息需要在 onBLECharacteristicValueChange 方法注册的回调中获取。具体参考官方文档。

deviceAdapter.getBLEDeviceRSSI()

获取蓝牙设备的信号强度。

deviceAdapter.notifyBLECharacteristicValueChange({ characteristicId?: string; serviceId?: string; state?: boolean }) => Promise

serviceId: string; 需要订阅的服务id，默认会取主服务id
characteristicId: string; 需要订阅的特征值id，默认会取主服务下的第一个notify或indicate特征值
state: boolean; 是否启用 notify，默认为 true

deviceAdapter.write: (hexString, options?: { writeId?: string; serviceId?: string }) => Promise

hexString: string; 需要写给蓝牙设备的16进制字符串
options.writeId; 可选，需要写入的特征值id，默认会取主服务下的第一个writeId
options.serviceId; 可选，需要写入的服务id，默认会取主服务id

往蓝牙设备写数据。

deviceAdapter.handleBLEMessage: (hexString, { serviceId, characteristicId }) => { reportData?: any, ...any }

子类继承基类后需要实现该方法，用于处理收到 onBLECharacteristicValueChange 回调后的协议解析。

返回值中如果返回 reportData，则会将该部分数据上报到云端（注意需与产品定义物模型匹配），其他字段则会透传到 message 事件的 payload 中。

deviceAdapter 事件

Event: 'connect'

设备连接后触发

Event: 'disconnect'

设备断开后触发

Event: 'message'

timestamp: number; 收到设备消息的时间戳，单位毫秒
dataReported: boolean; 收到设备的消息是否已上报云端
其他; handleBLEMessage 函数返回的其他参数将会透传到 message 事件中

当收到 onBLECharacteristicValueChange 回调，并经过 handleBLEMessage 处理后触发

Event: 'bLEConnectionStateChange'

connected: boolean; 设备是否连接

当 onBleConnectionStateChange 触发时触发，若 connected 为 true，则接下来会触发事件 'connect'，否则会触发事件 'disconnect'

标准蓝牙adapter新增的功能

从blueToothAdapter.getDeviceAdapter(deviceId) => deviceAdapter中获取到标准蓝牙的设备适配器

deviceAdapter.reconnectDevice({ deviceName: string }) => void

首次绑定之后，重新连接蓝牙设备，这个过程中，涉及到设备端和手机端的双向认证

deviceAdapter.unbindDevice({ familyId: string, deviceName: string }) => void

在跟云端解绑设备之前需要跟设备端交互解绑协议，此过程会清除设备端的鉴权信息

deviceAdapter.controlDevice({ deviceData: Object }) => void

手机端控制设备

deviceAdapter.controlAction({ actionData }) => void

手机端行为调用

deviceAdapter.startListenLLEvents()

监听云端事件，从而进行设备端的数据交互

设备分享时设置自定义分享参数

前往设备详情/分享列表页时，带上 shareParams 参数
被分享人接受分享后，可通过调用 sdk.getShareParams() 方法获取分享时设置的 shareParams 参数

CHANGELOG

v1.2.5(2021.1.14)

支持在腾讯连连 APP 环境中调用以下方法
- sdk.goDeviceDetailPage
- sdk.goFeedBackPage
- sdk.goDeviceInfoPage
- sdk.goEditDeviceNamePage
- sdk.goRoomSettingPage
- sdk.goShareDevicePage
- sdk.navBack
- sdk.reloadAfterUnmount
- sdk.setShareConfig
注意：运行于腾讯连连 APP 环境的 H5 面板不支持调用微信 JSSDK。在腾讯连连 APP 环境，sdk.wxSdkReady 返回一个 rejected 的 Promise

v1.2.1(2020.12.18)

优化蓝牙模块，增加已连接蓝牙设备缓存deviceId特性，增加断开后不清理deviceAdapter特性
增加 searchAndConnect 方法，自动处理尝试缓存及缓存失效后重搜逻辑

v1.1.22(2020.12.16)

完善文档：setBLEMTU

v1.1.21(2020.11.18)

支持标准蓝牙协议的设备搜索，设备绑定，设备控制，设备属性/事件上报，设备行为调用等功能

v1.1.20(2020.11.17)

升级 appdev-sdk，修复 token 失效后可能导致死循环问题

v1.1.19(2020.9.23)

蓝牙支持多服务、多特征值订阅，调整特征值内部储存方式；
蓝牙暴露 getBLEDeviceServices、getBLEDeviceCharacteristics、notifyBLECharacteristicValueChange 方法；
蓝牙 write 方法支持指定服务id及特征值id
connectDevice 支持不自动处理订阅特征值notify
增加readBLECharacteristicValue、getBLEDeviceRSSI 方法
修复固件升级功能 checkFirmwareUpgrade 方法通过参数传入 deviceId 时，设备在线状态判断有误的问题
修复蓝牙搜索页面 sdk.productId 值为空的问题
适配 H5 面板新样式风格

v1.1.18(2020.9.21)

增加固件升级功能

v1.1.16(2020.7.10)

修复设备收到 report 推送时会抛出错误问题
修复蓝牙未正常断开后重新调用 createBLEConnection 会抛出 already connect 错误问题

v1.1.15(2020.7.8)

修复蓝牙事件未触发问题

v1.1.11(2020.6.24)

sdk 增加 eventEmitter 能力，原 sdk.onWsClose 等方法增加 sdk.on('wsClose') 等监听事件方法
sdk 增加 appShow/appHide/pageShow/pageHide 等四个事件

v1.1.10(2020.6.19)

修复蓝牙发现页无设备id导致js报错问题

v1.1.9(2020.6.17)

增加分享设备可以带上自定义参数特性

v1.1.8(2020.6.16)

getDeviceData等若干方法支持传入 deviceId 等参数来指定需要获取数据的设备
sdk 增加暴露当前家庭下的房间列表 roomList 属性
修复文档若干错误及遗漏

v1.1.6(2020.6.15)

离线tips和设备详情页面 .btn 类名加上命名空间

v1.1.5(2020.6.12)

sdk.tips 增加 showModal/confirm/alert 方法
增加 sdk.themeColorMap，内置了连连默认的几种风格的色值
增加 sdk.goDeviceInfoPage 方法，跳转小程序设备信息页
增加 sdk.goEditDeviceNamePage 方法，跳转小程序设置设备名称页
增加 sdk.goRoomSettingPage 方法，跳转小程序设置设备房间页
增加 sdk.goShareDevicePage 方法，跳转小程序分享设备页
增加 sdk.deleteDevice 方法，可在h5内删除当前设备
增加 sdk.showDeviceDetail 方法，在当前h5展示一个铺满全屏的设备详情界面，支持自定义菜单项

FAQs

What is qcloud-iotexplorer-h5-panel-sdk?

Is qcloud-iotexplorer-h5-panel-sdk popular?

Is qcloud-iotexplorer-h5-panel-sdk well maintained?

Package last updated on 19 Apr 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install