com.midea.iot.sdk.openapi

Interface MSmartUserManager

All Superinterfaces:

MSmartConstant, MSmartKeyDefine

public interface MSmartUserManager
extends MSmartKeyDefine, MSmartConstant

用户管理接口.

本类提供了用户注册登陆以及管理相关的接口。
异步接口如果请求失败，会返回错误码和错误信息，错误信息为英文提示。

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	bindSubAccount(String uuid, String subAccount, MSmartCallback callback) 更新推送token值.
void	checkSubAccountState(String uuid, String subAccount, String randomStr, MSmartDataCallback<android.os.Bundle> callback) 检查子账号是否被绑定.
void	createSubAccount(String uuid, MSmartDataCallback<android.os.Bundle> callback) 创建子账号.
String	getUserID() 获取登陆用户ID.
void	getUserInfo(MSmartDataCallback<android.os.Bundle> callback) 获取登陆用户的详细信息.
void	getVerifyCodeBySMS(String mobileNum, String type, MSmartCallback callback) 获取短信验证码.
void	loginWithAccount(String account, String password, android.os.Bundle extraData, MSmartCallback callback) 用户登陆.
void	loginWithMideaAccount(String account, String password, String thirdToken, MSmartCallback callback) 美家账号登陆.
void	loginWithSubAccount(String uuid, String userID, String subAccount, MSmartCallback callback) 登陆子账号.
void	loginWithThirdAccessToken(String accessToken, String openID, int thirdSrc, android.os.Bundle extraData, MSmartCallback callback) 第三方开放账号体系登陆接口.
void	logout() 退出登录.
void	modifyPassword(String oldPassword, String newPassword, MSmartCallback callback) 修改密码.
void	modifyUserInfo(String nickName, boolean male, String age, String address, String phone, String signature, MSmartCallback callback) 修改用户信息.
void	modifyUserMobile(String password, String newMobile, String verifyCode, MSmartCallback callback) 修改用户绑定手机.
void	registerWithEmail(String email, String password, String nickName, MSmartCallback callback) 邮箱注册账号.
void	registerWithMideaAccount(String account, String password, String nickName, String thirdToken, MSmartCallback callback) 第三方注册美居账号.
void	registerWithMobileNum(String mobileNum, String password, String verifyCode, String nickName, MSmartCallback callback) 手机号注册账号.
void	resetPwdByEmail(String loginAccount, MSmartCallback callback) 邮箱重置密码.
void	resetPwdByMobile(String mobile, String verifyCode, String newPassword, MSmartCallback callback) 手机号重置密码.
void	searchUserByAccount(String userAccount, MSmartDataCallback<android.os.Bundle> callback) 通过用户账号查询用户.
void	updatePushToken(String pushToken, MSmartCallback callback) 更新推送token值.
void	updateUserSession(MSmartCallback callback) 刷新用户session.
void	uploadUserProfilePhoto(String picPath, MSmartDataCallback<android.os.Bundle> callback) 上传用户头像.

Method Detail

getVerifyCodeBySMS

void getVerifyCodeBySMS(String mobileNum,
                        String type,
                        MSmartCallback callback)

获取短信验证码.

请求成功后，对应手机随后会收到验证码短信,参数type的可取值类型：

验证码类型列表

验证码类型	常量	值
注册	MSmartConstant.VERIFY_CODE_TYPE_REGISTER	1
重置密码	MSmartConstant.VERIFY_CODE_TYPE_RESET_PWD	2
更新手机号	MSmartConstant.VERIFY_CODE_TYPE_UPDATE_MOBILE	3

Parameters:

mobileNum - 用户手机号

type - 短信验证码类型, 1为注册，2为修改密码，3为绑定手机

callback - 回调

registerWithMobileNum

void registerWithMobileNum(String mobileNum,
                           String password,
                           String verifyCode,
                           String nickName,
                           MSmartCallback callback)

手机号注册账号.

注册之前调用getVerifyCodeBySMS(String, String, MSmartCallback)获取验证码，验证码将作为初始密码
密码长度：6~12位有效.

Parameters:

mobileNum - 手机号

password - 密码

verifyCode - 验证码

nickName - 用户昵称

callback - 回调

See Also:

getVerifyCodeBySMS(String, String, MSmartCallback), registerWithEmail(String, String, String, MSmartCallback)

registerWithEmail

void registerWithEmail(String email,
                       String password,
                       String nickName,
                       MSmartCallback callback)

邮箱注册账号.

密码长度：6~12位有效

Parameters:

email - 邮箱

password - 密码

nickName - 用户昵称

callback - 回调

See Also:

registerWithMobileNum(String, String, String, String, MSmartCallback)

registerWithMideaAccount

void registerWithMideaAccount(String account,
                              String password,
                              String nickName,
                              String thirdToken,
                              MSmartCallback callback)

第三方注册美居账号.

Parameters:

account - 用户手机号或者邮箱

password - 登陆密码

nickName - 用户昵称

thirdToken - 第三方token

callback - 回调

loginWithAccount

void loginWithAccount(String account,
                      String password,
                      android.os.Bundle extraData,
                      MSmartCallback callback)

用户登陆.

不同的登陆方式，extraData的内容不同。

extraData中目前可以存放的有效键值

键	常量	值类型	说明
pushToken	MSmartKeyDefine.KEY_PUSH_TOKEN	String	推送Toke
phoneModel	MSmartKeyDefine.KEY_PHONE_MODEL	String	手机型号
phoneSysVNum	MSmartKeyDefine.KEY_PHONE_SYSTEM_VERSION	String	手机操作系统版本号
appVNum	MSmartKeyDefine.KEY_APP_VERSION	String	APP的版本号
pushType	MSmartKeyDefine.KEY_PUSH_TYPE	String	推送类型。1：MPUSH，2：JPUSH 4：Google推送

Parameters:

account - 账号：手机号或邮箱

password - 登录密码

extraData - 登陆附带的参数

callback - 回调

loginWithThirdAccessToken

void loginWithThirdAccessToken(String accessToken,
                               String openID,
                               int thirdSrc,
                               android.os.Bundle extraData,
                               MSmartCallback callback)

第三方开放账号体系登陆接口.

extraData中有效键值

键	常量	值类型	说明
pushToken	MSmartKeyDefine.KEY_PUSH_TOKEN	String	推送Toke
phoneModel	MSmartKeyDefine.KEY_PHONE_MODEL	String	手机型号
phoneSysVNum	MSmartKeyDefine.KEY_PHONE_SYSTEM_VERSION	String	手机操作系统版本号
appVNum	MSmartKeyDefine.KEY_APP_VERSION	String	APP的版本号
thirdNickName	MSmartKeyDefine.KEY_THIRD_NICK_NAME	String	用户名称

Parameters:

accessToken - 第三方访问授权Token

openID - 第三方来源ID

thirdSrc - 第三方来源标识

extraData - 登陆附带的参数

callback - 回调

loginWithMideaAccount

void loginWithMideaAccount(String account,
                           String password,
                           String thirdToken,
                           MSmartCallback callback)

美家账号登陆.

Parameters:

account - 用户手机号或者邮箱

password - 登录密码

thirdToken - 第三方token

callback - 回调

logout

void logout()

退出登录.

退出以后，SDK的接口将不可以继续调用。

getUserID

String getUserID()

获取登陆用户ID.

未登陆返回null。

Returns:

userId 用户ID

getUserInfo

void getUserInfo(MSmartDataCallback<android.os.Bundle> callback)

获取登陆用户的详细信息.

回调用户信息

键	常量	值类型	说明
userID	MSmartKeyDefine.KEY_USER_ID	String	用户ID
userNickName	MSmartKeyDefine.KEY_USER_NICKNAME	String	用户昵称
userMobile	MSmartKeyDefine.KEY_USER_MOBILE	String	手机号
userEmail	MSmartKeyDefine.KEY_USER_EMAIL	String	邮箱
userSex	MSmartKeyDefine.KEY_USER_SEX	String	性别
userAge	MSmartKeyDefine.KEY_USER_AGE	String	年龄
userAddress	MSmartKeyDefine.KEY_USER_ADDRESS	String	地址
userPhone	MSmartKeyDefine.KEY_USER_PHONE	String	电话
profilePicUrl	MSmartKeyDefine.KEY_PROFILE_PHOTO	String	头像
userSignature	MSmartKeyDefine.KEY_USER_SIGN	String	签名

Parameters:

callback - 回调

resetPwdByEmail

void resetPwdByEmail(String loginAccount,
                     MSmartCallback callback)

邮箱重置密码.

请求成功以后，邮箱会收到密码重置的邮件。

Parameters:

loginAccount - 邮箱

callback - 回调

resetPwdByMobile

void resetPwdByMobile(String mobile,
                      String verifyCode,
                      String newPassword,
                      MSmartCallback callback)

手机号重置密码.

重置密码需要调用getVerifyCodeBySMS(String, String, MSmartCallback)获取验证码

Parameters:

mobile - 手机号

verifyCode - 短信验证码

newPassword - 新密码

callback - 回调

See Also:

getVerifyCodeBySMS(String, String, MSmartCallback)

modifyPassword

void modifyPassword(String oldPassword,
                    String newPassword,
                    MSmartCallback callback)

修改密码.

Parameters:

oldPassword - 原密码

newPassword - 新密码

callback - 回调

searchUserByAccount

void searchUserByAccount(String userAccount,
                         MSmartDataCallback<android.os.Bundle> callback)

通过用户账号查询用户.

这个是精确搜索，必须输入正确完整的用户账号（邮箱或者手机号）。
请求成功会返回用户列表，Bundle中用户的信息如下：

回调用户信息

键	常量	值类型	说明
userID	MSmartKeyDefine.KEY_USER_ID	String	用户ID
userNickName	MSmartKeyDefine.KEY_USER_NICKNAME	String	用户昵称
userMobile	MSmartKeyDefine.KEY_USER_MOBILE	String	手机号
userEmail	MSmartKeyDefine.KEY_USER_EMAIL	String	邮箱
userSex	MSmartKeyDefine.KEY_USER_SEX	String	性别
userAge	MSmartKeyDefine.KEY_USER_AGE	String	年龄
userAddress	MSmartKeyDefine.KEY_USER_ADDRESS	String	地址
userPhone	MSmartKeyDefine.KEY_USER_PHONE	String	电话
userRegisterTime	MSmartKeyDefine.KEY_USER_REGISTER_TIME	String	注册时间
profilePicUrl	MSmartKeyDefine.KEY_PROFILE_PHOTO	String	头像
userSignature	MSmartKeyDefine.KEY_USER_SIGN	String	签名

Parameters:

userAccount - 账号

callback - 回调

modifyUserMobile

void modifyUserMobile(String password,
                      String newMobile,
                      String verifyCode,
                      MSmartCallback callback)

修改用户绑定手机.

修改用户绑定手机需要调用getVerifyCodeBySMS(String, String, MSmartCallback)获取验证码
验证码会发送到新手机号上。

Parameters:

password - 密码

newMobile - 手机号

verifyCode - 验证码

callback - 回调

See Also:

getVerifyCodeBySMS(String, String, MSmartCallback)

updateUserSession

void updateUserSession(MSmartCallback callback)

刷新用户session.

避免用户登陆过期。用户Session过期时间：2小时 如果失败需要重新登陆，建议每次后台进入前台就重新刷一下。

Parameters:

callback - 回调

modifyUserInfo

void modifyUserInfo(String nickName,
                    boolean male,
                    String age,
                    String address,
                    String phone,
                    String signature,
                    MSmartCallback callback)

修改用户信息.

用户仅可以修改自己的信息

Parameters:

nickName - 用户名

male - 性别，是否为男

age - 年龄

address - 地址

phone - 固定电话

signature - 签名

callback - 回调

uploadUserProfilePhoto

void uploadUserProfilePhoto(String picPath,
                            MSmartDataCallback<android.os.Bundle> callback)

上传用户头像.

图像大小不能超过200K。

回调的键值

键	常量	值类型	说明
profilePicUrl	MSmartKeyDefine.KEY_PROFILE_PHOTO	String	头像

Parameters:

picPath - 头像本地路径

callback - 回调

updatePushToken

void updatePushToken(String pushToken,
                     MSmartCallback callback)

更新推送token值.

如果登陆的时候没有上传推送的Token（pushToken）,登陆成功后可以再上传。

Parameters:

pushToken - 推送Token

callback - 回调

bindSubAccount

void bindSubAccount(String uuid,
                    String subAccount,
                    MSmartCallback callback)

更新推送token值.

Parameters:

uuid - 标识设备唯一性的ID

subAccount - 子账号

callback - 回调

createSubAccount

void createSubAccount(String uuid,
                      MSmartDataCallback<android.os.Bundle> callback)

创建子账号.

回调信息

键	常量	值类型	说明
subAccount	MSmartKeyDefine.KEY_SUB_ACCOUNT	String	子账号名称
randomStr	MSmartKeyDefine.KEY_RANDOM_STR	String	密钥
qrCode	MSmartKeyDefine.KEY_QR_CODE	String	二维码

Parameters:

uuid - 标识设备唯一性的ID

callback - 回调

checkSubAccountState

void checkSubAccountState(String uuid,
                          String subAccount,
                          String randomStr,
                          MSmartDataCallback<android.os.Bundle> callback)

检查子账号是否被绑定.

回调信息

键	常量	值类型	说明
userID	MSmartKeyDefine.KEY_USER_ID	String	主账号ID

Parameters:

uuid - 标识设备唯一性的ID

subAccount - 子账号

randomStr - 随机串

callback - 回调

loginWithSubAccount

void loginWithSubAccount(String uuid,
                         String userID,
                         String subAccount,
                         MSmartCallback callback)

登陆子账号.

Parameters:

uuid - 标识设备唯一性的ID

userID - 主账号用户ID

subAccount - 子账号

callback - 回调