账户管理

账号类型

类型	含义
品牌商账号	此账号不支持注册 该账号会绑定对应的 OEM SaaS 登录域名，向涂鸦购买OEM SaaS时提供的主账号。
企业主账号	您自主注册的账号均为企业主账号，拥有企业内的所有权限，可以创建/删除项目。
企业子账号	SaaS端登录企业主账号可创建企业子账号，为其分配权限，可限定访问特定功能。

注册账号

暂不支持 App 端主账号注册的功能，请在 涂鸦商照管理平台 开通企业主账号。

登录账号

账号体系设计为一个账号对应多个商户的模型。但目前商业照明限制为一对一，一个账号仅对应一个唯一商户。所以在登录时无需传入商户code，后台可以查询到当前账号对应的唯一商户。

登录方式支持：

• 账号密码登录

• 账号验证码登录

• 三方系统授权登录：该方法需配合 商用照明 OpenAPI 使用

  

  授权流程

  1. 三方系统服务端授权账户到涂鸦云，由三方系统決定授权账户的范围，可以是三方系统的用户或员工账号，也可以是内部任何业务形态对应一个账号授权到涂鸦云。如：企业，门店，项目等。
  2. 已经授权的账户，三方系统服务端通用账户加国家码，向涂鸦云申请一个 ticket。

  使用场景

  1. 涂鸦的系统域名加上这个 ticket，可实现免登跳转。示例: lighting.console.tuyacn.com?ticket=xxx。比如:访问涂鸦的系统网站，或扫码访问设备控制h5页面。
  2. 涂鸦商照sdk获取会话接口，传入 ticket，获取会话状态，访问完整的sdk能力。

接口说明

void loginByTicket(String ticket, ITuyaUserResultCallback<User> listener);

参数说明

参数	说明
ticket	通过授权流程获取ticket

示例代码

TuyaOSUser.getUserInstance().loginByTicket(content, new ITuyaUserResultCallback<User>() {
    @Override
    public void onSuccess(User user) {
        Log.e(TAG,"登录成功")
    }

    @Override
    public void onError(String code, String error) {
    	Log.e(TAG,"登录失败：" + error)
    }
});

找回或重置密码

此场景适用于忘记密码时：需要找回密码/重置密码。二者操作步骤相同，查询商户列表前需要验证权限。

遂分为三个步骤，首先获取找回密码的验证码, 将验证码传入查找商户列表, 获取对应单独商户执行找回密码的方修改密码。

更多详情，请 查看使用说明。

登出账号

账户基本信息存储/清除均在sdk内部处理，开发者无需关心账号信息的安全与同步。

登录成功后sdk会缓存账号基本信息，同时调用账号登出成功后，sdk也会清空当前账号缓存数据，开发者只需在成功回调后自行处理自己的业务逻辑即可。

更多详情，请 查看使用说明。

账号注销

企业主账号暂不支持账号注销功能，请在 IoT 平台 提交工单 进行人工审核。

账号绑定

目前商户账号体系暂不支持对账号设置绑定信息的功能。

例如，手机号注册的账户进行绑定邮箱，或邮箱注册的账户进行绑定手机号。

查询用户信息

账号固有属性（账号名，账号角色等）会在登录成功后作为账号属性返回，用户附加属性（昵称，头像等）则不会在登录成功后返回，需要通过获取用户信息额外查询。

同时获取用户信息可以在进行多端数据同步的场景下使用，其他端修改了用户附加属性，通过此方法同步最新数据。

修改用户信息

商业照明业务目前支持修改用户头像和修改昵称，均只需处理UI逻辑，后续的数据缓存等都在sdk内部处理，不需要开发者额外进行同步。