com.midea.iot.sdk.openapi

Interface MSmartUserDeviceManager

All Superinterfaces:

MSmartConstant, MSmartKeyDefine

public interface MSmartUserDeviceManager
extends MSmartKeyDefine, MSmartConstant

用户设备管理接口.

单用户设备模型，可以进行设备配网。
设备的状态包括：

1. 未配置:一般设备处于AP状态，对于这种设备需要执行配网操作，将设备连上路由器。
2. 已添加:设备已经连上了路由器并对设备执行了添加操作，可以控制设备，但是不能远程控制 。
3. 已绑定:对设备执行了绑定操作，可以进行远程控制。

设备共享：
设备的所有者称为设备主人，设备主人可以主动分享该设备，其他用户接受分享邀请，成为该设备的共享用户。
其他用户也可以主动向设备主人请求共享，设备主人同意后，也成为该设备的共享用户。

Field Summary

Fields inherited from interface com.midea.iot.sdk.openapi.common.MSmartKeyDefine

KEY_ACCEPT, KEY_APP_VERSION, KEY_CONTENT, KEY_CURRENT_STEP, KEY_DATA, KEY_DEVICE_DES, KEY_DEVICE_ID, KEY_DEVICE_IP, KEY_DEVICE_IS_ACTIVATED, KEY_DEVICE_IS_ADDED, KEY_DEVICE_IS_ONLINE, KEY_DEVICE_IS_SECRET_SET, KEY_DEVICE_MAC, KEY_DEVICE_NAME, KEY_DEVICE_NEW_FAMILY_ID, KEY_DEVICE_NEW_FAMILY_NUMBER, KEY_DEVICE_OLD_FAMILY_ID, KEY_DEVICE_OLD_FAMILY_NUMBER, KEY_DEVICE_SN, KEY_DEVICE_SSID, KEY_DEVICE_SUB_TYPE, KEY_DEVICE_TSN, KEY_DEVICE_TYPE, KEY_DEVICE_TYPE_NAME, KEY_FAMILY_ADDRESS, KEY_FAMILY_BG, KEY_FAMILY_COORDINATE, KEY_FAMILY_CREATE_TIME, KEY_FAMILY_DESCRIPTION, KEY_FAMILY_ID, KEY_FAMILY_MEMBER_ACCOUNT, KEY_FAMILY_MEMBER_ID, KEY_FAMILY_NAME, KEY_FAMILY_NUMBER, KEY_FAMILY_OWNER_EMAIL, KEY_FAMILY_OWNER_MOBILE, KEY_FAMILY_OWNER_NICKNAME, KEY_FIRMWARE_INFO, KEY_FIRMWARE_URL, KEY_IS_DEFAULT_FAMILY, KEY_IS_DEVICE_OWNER, KEY_IS_FAMILY_OWNER, KEY_NEED_USER_OPERATION, KEY_NEW_OWNER_ACCOUNT, KEY_NEW_OWNER_ID, KEY_OLD_OWNER_ACCOUNT, KEY_OLD_OWNER_ID, KEY_OTA_CREATE_TIME, KEY_OTA_NEW_VERSION, KEY_OTA_PACKAGE_DESC, KEY_OTA_PACKAGE_SIZE, KEY_OTA_RULE, KEY_OTA_TYPE, KEY_OTA_VERSION, KEY_OWNER_ACCOUNT, KEY_OWNER_ID, KEY_PHONE_MODEL, KEY_PHONE_SYSTEM_VERSION, KEY_PROFILE_PHOTO, KEY_PUSH_CONTENT, KEY_PUSH_TOKEN, KEY_PUSH_TYPE, KEY_QR_CODE, KEY_RANDOM_STR, KEY_ROUTER_SSID, KEY_STEP_NAME, KEY_SUB_ACCOUNT, KEY_THIRD_NICK_NAME, KEY_TIPS, KEY_TOTAL_STEP, KEY_USER_ACCOUNT, KEY_USER_ADDRESS, KEY_USER_AGE, KEY_USER_EMAIL, KEY_USER_ID, KEY_USER_MOBILE, KEY_USER_NAME, KEY_USER_NICKNAME, KEY_USER_PHONE, KEY_USER_REGISTER_TIME, KEY_USER_SEX, KEY_USER_SIGN

Fields inherited from interface com.midea.iot.sdk.openapi.common.MSmartConstant

CONFIGURE_TYPE_AP, CONFIGURE_TYPE_MSC, CONFIGURE_TYPE_ONE_AP, CONFIGURE_TYPE_ONE_MSC, CONFIGURE_TYPE_UNKNOWN, GENDER_FEMALE, GENDER_MALE, VERIFY_CODE_TYPE_REGISTER, VERIFY_CODE_TYPE_RESET_PWD, VERIFY_CODE_TYPE_UPDATE_MOBILE

Method Summary

Modifier and Type	Method and Description
void	activeDevice(String deviceSN, MSmartCallback callback) 绑定用户设备.
void	addDevice(String deviceID, String deviceSSID, MSmartStepDataCallback<android.os.Bundle> callback) 添加已配置设备.
void	applyDevice(String deviceID, String userID, MSmartCallback callback) 设备分享申请(设备共享用户调用).
void	checkOTAFirmware(String version, MSmartDataCallback<android.os.Bundle> callback) 从服务器上查询最近的固件版本.
void	confirmDeviceApply(String deviceID, String userID, boolean isAccept, MSmartCallback callback) 响应分享设备申请(设备主人调用).
void	confirmDeviceInvitation(String deviceID, String userID, boolean isAccept, MSmartCallback callback) 响应设备分享要求(设备共享用户调用).
void	deleteDevice(String deviceID, MSmartCallback callback) 移除设备.
void	deleteDeviceUser(String userID, String deviceID, MSmartCallback callback) 撤销分享设备(删除设备共享用户,设备主人调用).
void	getAllDeviceList(MSmartDataCallback<List<android.os.Bundle>> callback) 获取登陆用户已添加的设备.
int	getConfigureTypeByQRCode(String qrCode) 获取配网方式.
void	getDeiceBindInfo(String deviceID, MSmartDataCallback<android.os.Bundle> callback) 获取设备绑定信息.
void	getDeviceByID(String deviceID, MSmartDataCallback<android.os.Bundle> callback) 通过设备ID获取设备列表.
MSmartDeviceState	getDeviceState(String deviceID) 查询缓存的设备全状态.
void	getDeviceTypeName(String deviceType, MSmartDataCallback<android.os.Bundle> callback) 获取设备类型名称.
void	getDeviceUserList(List<String> deviceIDs, MSmartDataCallback<List<android.os.Bundle>> callback) 批量获取设备共享用户列表.
void	getDeviceUserList(String deviceID, MSmartDataCallback<List<android.os.Bundle>> callback) 获取设备共享用户列表.
void	inviteDeviceUser(String userID, String deviceID, MSmartCallback callback) 设备分享邀请(邀请用户共享设备，设备主人调用).
void	modifyDeviceInfo(String deviceID, String deviceName, String deviceDes, MSmartCallback callback) 修改设备信息.
void	queryDeviceCurrentVer(String deviceSSID, MSmartStepDataCallback<android.os.Bundle> callback) 查询设备的当前版本号.
void	queryDeviceOTAVersion(String deviceID, MSmartDataCallback<List<android.os.Bundle>> callback) 查询设备OTA版本.
void	queryDeviceState(String deviceID, boolean queryFlag, MSmartDataCallback<MSmartDeviceState> callback) 查询设备全状态.
void	registerDeviceScanListener(MSmartDeviceScanListener listener) 注册设备扫描监听器.
void	removeDeviceScanListener(MSmartDeviceScanListener listener) 移除设备扫描监听器.
void	resumeConfigureDevice() 恢复配网.
void	sendDataToBaseServer(String baseType, String queryData, String data, MSmartDataCallback<android.os.Bundle> callback) 应用服务器透传接口(仅限美的事业部使用).
void	sendDeviceData(String deviceID, byte[] data, MSmartDataCallback<byte[]> callback) 发送控制命令数据给设备.
void	startConfigureDevice(android.net.wifi.ScanResult scanResult, String password, int configureType, String deviceSSID, MSmartStepDataCallback<android.os.Bundle> callback) 启动设备配网.
void	startConfigureDevice(String routerSSID, String password, String capabilities, int configureType, String deviceSSID, MSmartStepDataCallback<android.os.Bundle> callback) 启动设备配网.
void	startDeviceOTA(String deviceID, MSmartCallback callback) 启动升级.
void	startOTAUpdate(String deviceSSID, String filePath, boolean reboot, MSmartStepDataCallback<android.os.Bundle> callback) 开始OTA升级
void	startScanLanDevice(int time, MSmartDataCallback<List<android.os.Bundle>> callback) 扫描网络中的家电设备.
void	stopAddDevice() 停止添加已配置设备.
void	stopConfigureDevice() 停止设备配网.
void	updateDeviceState(String deviceID, Map<String,String> stateMap, MSmartDataCallback<MSmartDeviceState> callback) 控制设备.

Method Detail

startConfigureDevice

void startConfigureDevice(android.net.wifi.ScanResult scanResult,
                          String password,
                          int configureType,
                          String deviceSSID,
                          MSmartStepDataCallback<android.os.Bundle> callback)

启动设备配网.

启动设备配网，将设备配置指定的WIFI网络中，配网成功后设备已经连入到这个网络，在网络中可以扫描到设备。
有多种设备配网类型，请配网前确定好配网类型getConfigureTypeByQRCode(String),不建议配置到信号较弱的网络中。
配网之前请确保设备处于重置状态，如果之前执行了配网操作，没有停止，继续调用配网接口无效。

在配网过程中，部分操作容易失败，例如在6.0系统上连接热点有可能因为权限等问题造成失败,部分操作可以手动执行后，继续进行配网流程。 例如：在收配网错误时,通过MSmartErrorMessage.getExtras()得到错误的附加数据，然后判断附加数据中是否包含 收到错误回调的时候，通过，通过判断错误回调时是否包含MSmartKeyDefine.KEY_NEED_USER_OPERATION参数并且参数的值是true的时候可以根据当前操作类型提示用户手动操作。
等完成操作后调用resumeConfigureDevice()继续执行配网。

配网成功设备信息内容

键	健常量	值类型	说明
deviceName	MSmartKeyDefine.KEY_DEVICE_NAME	String	设备名称
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID
deviceType	MSmartKeyDefine.KEY_DEVICE_TYPE	String	设备类型
deviceSubType	MSmartKeyDefine.KEY_DEVICE_SUB_TYPE	String	设备子类型
deviceSSID	MSmartKeyDefine.KEY_DEVICE_SSID	String	设备热点名称(SSID)
SN	MSmartKeyDefine.KEY_DEVICE_SN	String	设备SN

配网进度回调内容

键	健常量	值类型	说明
totalStep	MSmartKeyDefine.KEY_TOTAL_STEP	String	总配置步骤数量
currentStep	MSmartKeyDefine.KEY_CURRENT_STEP	String	当前配置步骤
stepName	MSmartKeyDefine.KEY_STEP_NAME	String	当前配置步骤描述（英文）

配网错误消息携带的数据

键	健常量	值类型	说明
manualOperation	MSmartKeyDefine.KEY_NEED_USER_OPERATION	boolean	用户手动操作提示

Parameters:

scanResult - WIFI网络

password - WIFI网络密码

configureType - 配网类型

deviceSSID - 待配置设备的SSID

callback - 回调

See Also:

getConfigureTypeByQRCode(String)

startConfigureDevice

void startConfigureDevice(String routerSSID,
                          String password,
                          String capabilities,
                          int configureType,
                          String deviceSSID,
                          MSmartStepDataCallback<android.os.Bundle> callback)

启动设备配网.

启动设备配网，将设备配置指定的WIFI网络中，配网成功后设备已经连入到这个网络，在网络中可以扫描到设备。
有多种设备配网类型，请配网前确定好配网类型getConfigureTypeByQRCode(String),不建议配置到信号较弱的网络中。
配网之前请确保设备处于重置状态，如果之前执行了配网操作，没有停止，继续调用配网接口无效。

在配网过程中，部分操作容易失败，例如在6.0系统上连接热点有可能因为权限等问题造成失败,部分操作可以手动执行后，继续进行配网流程。 例如：在收配网错误时,通过MSmartErrorMessage.getExtras()得到错误的附加数据，然后判断附加数据中是否包含 收到错误回调的时候，通过，通过判断错误回调时是否包含MSmartKeyDefine.KEY_NEED_USER_OPERATION参数并且参数的值是true的时候可以根据当前操作类型提示用户手动操作。
等完成操作后调用resumeConfigureDevice()继续执行配网。
目前不支持EAP企业级网络，网络加密类型来自扫描的热点，如果连接隐藏网络，可以传入空，WEP,WAP三个字符串。

配网成功设备信息内容

键	健常量	值类型	说明
deviceName	MSmartKeyDefine.KEY_DEVICE_NAME	String	设备名称
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID
deviceType	MSmartKeyDefine.KEY_DEVICE_TYPE	String	设备类型
deviceSubType	MSmartKeyDefine.KEY_DEVICE_SUB_TYPE	String	设备子类型
deviceSSID	MSmartKeyDefine.KEY_DEVICE_SSID	String	设备热点名称(SSID)
SN	MSmartKeyDefine.KEY_DEVICE_SN	String	设备SN

配网进度回调内容

键	健常量	值类型	说明
totalStep	MSmartKeyDefine.KEY_TOTAL_STEP	int	总配置步骤数量
currentStep	MSmartKeyDefine.KEY_CURRENT_STEP	int	当前配置步骤
stepName	MSmartKeyDefine.KEY_STEP_NAME	int	当前配置步骤描述（英文）

配网错误消息携带的数据

键	健常量	值类型	说明
manualOperation	MSmartKeyDefine.KEY_NEED_USER_OPERATION	boolean	用户手动操作提示

Parameters:

routerSSID - WIFI网络名称(SSID)

password - WIFI网络密码

capabilities - WIFI网络加密方式

configureType - 配网类型

deviceSSID - 待配置设备的SSID

callback - 回调

See Also:

startConfigureDevice(ScanResult, String, int, String, MSmartStepDataCallback)

resumeConfigureDevice

void resumeConfigureDevice()

恢复配网.

恢复正在进行的配网任务。
部分配网操作。

stopConfigureDevice

void stopConfigureDevice()

停止设备配网.

停止正在进行的配网任务。
如果未执行配网任务，这个接口会直接返回，不会造成其它影响。

See Also:

startConfigureDevice(ScanResult, String, int, String, MSmartStepDataCallback), startConfigureDevice(String, String, String, int, String, MSmartStepDataCallback)

getConfigureTypeByQRCode

int getConfigureTypeByQRCode(String qrCode)

获取配网方式.

不同的二维码对应着不同的配网方式，通过判断二维的格式来得到响应的配网方式。

配网方式列表

配网类型	常量定义	常量值
一机一码AP配网	MSmartConstant.CONFIGURE_TYPE_AP	6101
一型一码AP配网	MSmartConstant.CONFIGURE_TYPE_ONE_AP	6116
一机一码快连配网	MSmartConstant.CONFIGURE_TYPE_MSC	6102
一型一码快连配网	MSmartConstant.CONFIGURE_TYPE_ONE_MSC	6117
无效配网类型	MSmartConstant.CONFIGURE_TYPE_UNKNOWN	6104

Parameters:

qrCode - 二维码

Returns:

配网方式

See Also:

startConfigureDevice(ScanResult, String, int, String, MSmartStepDataCallback), startConfigureDevice(String, String, String, int, String, MSmartStepDataCallback)

addDevice

void addDevice(String deviceID,
               String deviceSSID,
               MSmartStepDataCallback<android.os.Bundle> callback)

添加已配置设备.

根据设备的SSID把已配置设备添加到SDK中, 添加之后的家电称为已添加设备，设备等待激活/绑定。
已配置设备：已经连入局域网的设备，一般可以通过局域网扫描接口扫描到的设备。
请求成功后，返回设备相关信息，当前登陆用户成为设备主人。回调的设备信息如下：

回调设备信息

键	值类型	说明
deviceName	String	设备名称
deviceID	String	设备ID
deviceType	String	设备类型
deviceSubType	String	设备子类型
deviceSSID	String	设备热点名称(SSID)
deviceSN	String	设备SN
isAdded	boolean	设备是否添加
isActivated	boolean	设备是否激活
isOnline	boolean	设备是否在线

Parameters:

deviceID - 设备ID

deviceSSID - 设备SSID

callback - 回调

stopAddDevice

void stopAddDevice()

停止添加已配置设备.

和addDevice(String, String, MSmartStepDataCallback)配对使用的接口，停止正在添加已配置设备任务。
如果未执行添加已配置设备，调用这个接口不会有回调也不会造成其它影响。

See Also:

addDevice(String, String, MSmartStepDataCallback)

activeDevice

void activeDevice(String deviceSN,
                  MSmartCallback callback)

绑定用户设备.

只能绑定已经添加过的设备，绑定成功后，用户成为设备的主人。

Parameters:

deviceSN - 设备SN

callback - 回调

See Also:

deleteDevice(String, MSmartCallback)

startScanLanDevice

void startScanLanDevice(int time,
                        MSmartDataCallback<List<android.os.Bundle>> callback)

扫描网络中的家电设备.

通过主动发送广播扫描当前局域网环境中的设备,返回在time参数指定的时间内扫描的所有设备。
设备配网成功后就可以扫描到，也可以扫描到已经添加并激活/绑定的设备。

设备信息内容

键	常量	值类型	说明
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID
deviceSN	MSmartKeyDefine.KEY_DEVICE_SN	String	设备SN
deviceType	MSmartKeyDefine.KEY_DEVICE_TYPE	String	设备类型
deviceSubType	MSmartKeyDefine.KEY_DEVICE_SUB_TYPE	String	设备子类型
deviceSSID	MSmartKeyDefine.KEY_DEVICE_SSID	String	设备热点名称(SSID)

Parameters:

time - 时间范围

callback - 扫描结果

See Also:

MSmartDeviceScanListener

registerDeviceScanListener

void registerDeviceScanListener(MSmartDeviceScanListener listener)

注册设备扫描监听器.

注册以后可以实时监听设备列表变化，一旦收到设备消息立即通知。
如果无需继续监听设备列表，调用removeDeviceScanListener(MSmartDeviceScanListener)

Parameters:

listener - 监听器

See Also:

MSmartDeviceScanListener

removeDeviceScanListener

void removeDeviceScanListener(MSmartDeviceScanListener listener)

移除设备扫描监听器.

Parameters:

listener - 监听器

See Also:

MSmartDeviceScanListener

updateDeviceState

void updateDeviceState(String deviceID,
                       Map<String,String> stateMap,
                       MSmartDataCallback<MSmartDeviceState> callback)

控制设备.

设备状态参照具体的设备协议文档。

Parameters:

deviceID - 设备DeviceID。

stateMap - 设备需要控制的状态。

callback - 控制回调，返回设备全状态。

getDeviceState

MSmartDeviceState getDeviceState(String deviceID)

查询缓存的设备全状态.

Parameters:

deviceID - 设备DeviceID

Returns:

返回设备全状态的Map

queryDeviceState

void queryDeviceState(String deviceID,
                      boolean queryFlag,
                      MSmartDataCallback<MSmartDeviceState> callback)

查询设备全状态.

Parameters:

deviceID - 设备ID

queryFlag - true：发送查询命令到设备并获取结果，false：不发送命令，直接获取缓存数据，可能返回null.

callback - 回调

sendDeviceData

void sendDeviceData(String deviceID,
                    byte[] data,
                    MSmartDataCallback<byte[]> callback)

发送控制命令数据给设备.

这个接口可以提供发送原始数据的

Parameters:

deviceID - 设备ID

data - 控制命令数据

callback - 返回控制状态数据

modifyDeviceInfo

void modifyDeviceInfo(String deviceID,
                      String deviceName,
                      String deviceDes,
                      MSmartCallback callback)

修改设备信息.

Parameters:

deviceID - 设备ID

deviceName - 修改后的设备名称

deviceDes - 修改后的设备描述

callback - 回调

getDeviceTypeName

void getDeviceTypeName(String deviceType,
                       MSmartDataCallback<android.os.Bundle> callback)

获取设备类型名称.

如果参数deviceType取值"0xFF"，则返回全部设备类型。 设备类型的名称目前仅支持中文和英文。

鉴权成功回调设备信息

键	常量	值类型	说明
deviceType	MSmartKeyDefine.KEY_DEVICE_TYPE	String	设备类型
deviceTypeName	MSmartKeyDefine.KEY_DEVICE_TYPE_NAME	String	设备类型名称

Parameters:

deviceType - 设备类型

callback - 回调

queryDeviceCurrentVer

void queryDeviceCurrentVer(String deviceSSID,
                           MSmartStepDataCallback<android.os.Bundle> callback)

查询设备的当前版本号.

Parameters:

deviceSSID - 设备ssid

callback - 状态回调

checkOTAFirmware

void checkOTAFirmware(String version,
                      MSmartDataCallback<android.os.Bundle> callback)

从服务器上查询最近的固件版本.

回调的键值

键	常量	值类型	说明
firmware_url	MSmartKeyDefine.KEY_FIRMWARE_URL	String	固件地址
firmware_info	MSmartKeyDefine.KEY_FIRMWARE_INFO	String	固件信息

Parameters:

version - 当前版本号

callback - 回调

queryDeviceOTAVersion

void queryDeviceOTAVersion(String deviceID,
                           MSmartDataCallback<List<android.os.Bundle>> callback)

查询设备OTA版本.

查询成功回调信息

键	常量	值类型	说明
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID
deviceSN	MSmartKeyDefine.KEY_DEVICE_SN	String	设备SN
otaType	MSmartKeyDefine.KEY_OTA_TYPE	String	升级类型，"0":模块升级，"1":电控升级
otaVersion	MSmartKeyDefine.KEY_OTA_VERSION	String	当前版本
otaNewVersion	MSmartKeyDefine.KEY_OTA_NEW_VERSION	String	新版本
otaRule	MSmartKeyDefine.KEY_OTA_RULE	String	升级规则，"1":命令升级，"2":强制升级
otaPackageSize	MSmartKeyDefine.KEY_OTA_PACKAGE_SIZE	String	包大小
otaPackageDesc	MSmartKeyDefine.KEY_OTA_PACKAGE_DESC	String	包说明
otaCreateTime	MSmartKeyDefine.KEY_OTA_CREATE_TIME	String	包创建时间

Parameters:

deviceID - 设备ID

callback - 回调

startOTAUpdate

void startOTAUpdate(String deviceSSID,
                    String filePath,
                    boolean reboot,
                    MSmartStepDataCallback<android.os.Bundle> callback)

开始OTA升级

Parameters:

deviceSSID - 设备ssid

filePath - OTA文件的路径

reboot - 重启模块标志，升级文件传输完成后，有些模块需要重启

callback - 回调

startDeviceOTA

void startDeviceOTA(String deviceID,
                    MSmartCallback callback)

启动升级.

向设备发送升级指令，发送成功则回调成功，设备升级过程中，设备将无法与外界建立联系，无法展示设备升级过程以及升级结果。
设备升级过程中无法进行控制。

Parameters:

deviceID - 设备ID

callback - 回调

getAllDeviceList

void getAllDeviceList(MSmartDataCallback<List<android.os.Bundle>> callback)

获取登陆用户已添加的设备.

获取当前登陆用户已添加(包括已绑定的设备)。

回调设备信息

键	常量	值类型	说明
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID
deviceSN	MSmartKeyDefine.KEY_DEVICE_SN	String	设备SN
deviceName	MSmartKeyDefine.KEY_DEVICE_NAME	String	设备名称
deviceType	MSmartKeyDefine.KEY_DEVICE_TYPE	String	设备类型
deviceSubType	MSmartKeyDefine.KEY_DEVICE_SUB_TYPE	String	设备子类型
deviceSSID	MSmartKeyDefine.KEY_DEVICE_SSID	String	设备热点名称(SSID)
isAdded	MSmartKeyDefine.KEY_DEVICE_IS_ADDED	boolean	设备是否添加
isActivated	MSmartKeyDefine.KEY_DEVICE_IS_ACTIVATED	boolean	设备是否激活
isOnline	MSmartKeyDefine.KEY_DEVICE_IS_ONLINE	boolean	设备是否在线
isDeviceOwner	MSmartKeyDefine.KEY_IS_DEVICE_OWNER	boolean	是否是设备主人

Parameters:

callback - 回调

getDeviceByID

void getDeviceByID(String deviceID,
                   MSmartDataCallback<android.os.Bundle> callback)

通过设备ID获取设备列表.

回调设备信息

键	常量	值类型	说明
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID
deviceSN	MSmartKeyDefine.KEY_DEVICE_SN	String	设备SN
deviceName	MSmartKeyDefine.KEY_DEVICE_NAME	String	设备名称
deviceType	MSmartKeyDefine.KEY_DEVICE_TYPE	String	设备类型
deviceSubType	MSmartKeyDefine.KEY_DEVICE_SUB_TYPE	String	设备子类型
deviceSSID	MSmartKeyDefine.KEY_DEVICE_SSID	String	设备热点名称(SSID)
isAdded	MSmartKeyDefine.KEY_DEVICE_IS_ADDED	boolean	设备是否添加
isActivated	MSmartKeyDefine.KEY_DEVICE_IS_ACTIVATED	boolean	设备是否激活
isOnline	MSmartKeyDefine.KEY_DEVICE_IS_ONLINE	boolean	设备是否在线
isDeviceOwner	MSmartKeyDefine.KEY_IS_DEVICE_OWNER	boolean	是否是设备主人

Parameters:

deviceID - ID

callback - 回调

deleteDevice

void deleteDevice(String deviceID,
                  MSmartCallback callback)

移除设备.

只能解绑用户已经绑定过的设备。
解绑成功后，用户失去设备的控制权限，如果是设备主人移除设备，则设备的所有共享者都会失去该设备。
解绑成功以后，设备直接处于未添加状态。

Parameters:

deviceID - 设备ID

callback - 回调

See Also:

activeDevice(String, MSmartCallback)

getDeiceBindInfo

void getDeiceBindInfo(String deviceID,
                      MSmartDataCallback<android.os.Bundle> callback)

获取设备绑定信息.

Parameters:

deviceID - 设备ID

callback - callback

getDeviceUserList

void getDeviceUserList(List<String> deviceIDs,
                       MSmartDataCallback<List<android.os.Bundle>> callback)

批量获取设备共享用户列表.

这个接口返回的用户列表包含设备主人本人。
这个接口只能设备主人调用，当前登陆用户是参数deviceIDs中的所有设备的主人。

回调用户设备信息

键	常量	值类型	说明
userEmail	MSmartKeyDefine.KEY_USER_EMAIL	String	用户email
userMobile	MSmartKeyDefine.KEY_USER_MOBILE	String	用户手机
userNickName	MSmartKeyDefine.KEY_USER_NICKNAME	String	用户昵称
userID	MSmartKeyDefine.KEY_USER_ID	String	用户ID
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID

Parameters:

deviceIDs - 设备ID列表

callback - 回调

See Also:

getDeviceUserList(String, MSmartDataCallback)

getDeviceUserList

void getDeviceUserList(String deviceID,
                       MSmartDataCallback<List<android.os.Bundle>> callback)

获取设备共享用户列表.

这个接口返回的用户列表包含设备主人本人。
这个接口只能设备主人调用，当前登陆用户是参数deviceID设备的主人。

回调用户设备信息

键	常量	值类型	说明
userEmail	MSmartKeyDefine.KEY_USER_EMAIL	String	用户email
userMobile	MSmartKeyDefine.KEY_USER_MOBILE	String	用户手机
userNickName	MSmartKeyDefine.KEY_USER_NICKNAME	String	用户昵称
userID	MSmartKeyDefine.KEY_USER_ID	String	用户ID
deviceID	MSmartKeyDefine.KEY_DEVICE_ID	String	设备ID

Parameters:

deviceID - 设备ID

callback - 回调

See Also:

getDeviceUserList(List, MSmartDataCallback)

inviteDeviceUser

void inviteDeviceUser(String userID,
                      String deviceID,
                      MSmartCallback callback)

设备分享邀请(邀请用户共享设备，设备主人调用).

主人主动发起的分享活动。请求成功后，用户会收到设备分享通知
用户调用confirmDeviceInvitation(String, String, boolean, MSmartCallback)进行确认。

Parameters:

userID - 用户ID

deviceID - 设备ID

callback - 回调

See Also:

confirmDeviceInvitation(String, String, boolean, MSmartCallback)

confirmDeviceInvitation

void confirmDeviceInvitation(String deviceID,
                             String userID,
                             boolean isAccept,
                             MSmartCallback callback)

响应设备分享要求(设备共享用户调用).

设备主人邀请用户共享设备inviteDeviceUser(String, String, MSmartCallback)
如果用户同意分享邀请，用户成为该设备共享者。

Parameters:

deviceID - 设备ID

userID - 主人ID

isAccept - 是否同意

callback - 回调

See Also:

inviteDeviceUser(String, String, MSmartCallback)

applyDevice

void applyDevice(String deviceID,
                 String userID,
                 MSmartCallback callback)

设备分享申请(设备共享用户调用).

用户向设备主人发起分享设备申请,请求成功后，设备主人会收到通知。
如果设备主人同意分享该设备confirmDeviceApply(String, String, boolean, MSmartCallback)，用户就能控制这个设备。

Parameters:

deviceID - 设备ID

userID - 用户ID

callback - 回调

See Also:

confirmDeviceApply(String, String, boolean, MSmartCallback)

confirmDeviceApply

void confirmDeviceApply(String deviceID,
                        String userID,
                        boolean isAccept,
                        MSmartCallback callback)

响应分享设备申请(设备主人调用).

用户执行了请求分享设备以后applyDevice(String, String, MSmartCallback)，设备主人响应这个请求.
如果同意分享，用户将成为该设备共享用户。
普通设备共享用户无权限调用。

Parameters:

deviceID - 设备ID

userID - 发送分享请求的用户ID

isAccept - 是否同意

callback - 回调

See Also:

applyDevice(String, String, MSmartCallback)

deleteDeviceUser

void deleteDeviceUser(String userID,
                      String deviceID,
                      MSmartCallback callback)

撤销分享设备(删除设备共享用户,设备主人调用).

设备主人调用这个接口可以取消单个用户的设备共享。
普通共享用户无权限。

Parameters:

userID - 用户ID

deviceID - 设备ID

callback - 回调

sendDataToBaseServer

void sendDataToBaseServer(String baseType,
                          String queryData,
                          String data,
                          MSmartDataCallback<android.os.Bundle> callback)

应用服务器透传接口(仅限美的事业部使用).

Parameters:

baseType - 服务器类型

queryData - 请求数据

data - 传输数据

callback - 回调