账号管理

更新时间:2024-06-26 01:42:30下载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, IThingUserResultCallback<User> listener);

参数说明

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

示例代码

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

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

重置密码

此场景适用于忘记密码时,需要找回密码或重置密码。二者操作步骤相同,查询商户列表前需要验证权限。分为三个步骤:

  1. 获取找回密码的验证码。
  2. 将验证码传入查找商户列表。
  3. 获取对应单独商户,执行找回密码的方法修改密码。

更多详情,查看使用说明

登出账号

账号基本信息存储和清除均在 SDK 内部处理,您无需关心账号信息的安全与同步。

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

更多详情,查看使用说明

注销账号

企业主账号暂不支持账号注销功能,请在涂鸦开发者平台 提交工单 进行人工审核。

绑定账号

目前,商户账号体系暂不支持对账号设置绑定信息的功能。例如,手机号注册的账号可以绑定邮箱,或邮箱注册的账号可以绑定手机号。

查询账号信息

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

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