账户管理

更新时间:2022-02-17 05:18:49下载pdf

账号类型

类型 含义
品牌商账号 此账号不支持注册
该账号会绑定对应的 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内部处理,不需要开发者额外进行同步。