使用SDK进行呼叫之前,您需要首先进行注册或登录。在云视讯平台每个用户有唯一的账号标识。SDK提供三方账号登录以及小鱼系统账号登录两种登录方式。
如果您的业务系统中已有用户账户系统并且希望您业务系统中的用户账户在云视讯平台有唯一的用户标识,以便后期对用户的音视频呼叫进行管理,您可以使用loginExternalAccount方法进行登录。
您可以使用您的应用系统中的用户账号登录云视讯平台,登录成功后平台将返回当前账户在云视讯平台的呼叫号码,后期该号码将作为该账户的唯一标识,每次登录后均使用同一呼叫号码,因此建议您将您应用系统的用户账户与云视讯平台的呼叫号码建立一一对应的关系并进行保存,以便在后期的业务场景中使用。
如果当前登录的账户在云视讯平台不存在,则平台将会注册一个新账户并登录,如果已经存在则使用已存在的账户进行登录。
提示:有效期内三方账号数量默认支持十万,数量如不满足需求请联系小鱼支持人员。
如果您已经在小鱼管理后台创建了账户并希望使用小鱼系统账户登录,您可以使用loginXYAccount方法进行登录。已创建的小鱼账号统一在小鱼管理后台进行管理,包含账号所属组织机构的管理。
您可以通过loginExtUserId方法进行三方账户的注册或登录,并通过此方法获取到登录状态的回调。 该方法中userUuid为三方用户登录ID,作为唯一用户标识,取值限制为 长度不超过50位且仅由0-9, a-Z, A-Z, - or _组成 的字符串;displayName字段为用户昵称, 建议使用普通汉字或者英文字符,且不能包含#、@、;、: 、=、-、()、[] 等非法字符。authCode 参数的生成需要参考服务端文档。
登录状态通过onLoginStateChanged回调获取:
提示:登录频次限制1分钟内小于10次。
备注: 收到onKickOut之后需要自主调用logout方法, 统一在登录状态回调中处理
/**
* 第三方账户登录
* @param extId 企业标志,联系小鱼销售人员获取
* @param displayName 显示名称
* @param extUID 三方用户ID,同一企业不能相同
* @param authCode 授权码
*/
loginExtUserId(extId: string, displayName: string, extUID: string, authCode: string) {
XYRTCEngine.getInstance().loginExtUserId(extId, displayName, extUID, authCode);
}
/**
* 账号登录
* @param extId 企业标志,联系小鱼销售人员获取
* @param countryCode 国家码
* @param account 用户名
* @param password 密码
*/
loginXYAccount(extId: string, countryCode: string, account: string, password: string) {
XYRTCEngine.getInstance().loginXYLinkAccount(extId, countryCode, account, password);
}