初始化客服（InitCustomer）

AndroidiOSWindows
如果您使用的是 Unity 引擎，请参见 Unity SDK 的 InitCustomer。

初始化客服。用户调用其他接口前必须收到异步回调。

函数定义

UFUNCTION(BlueprintCallable, Category = "INTLSDKAPI")
static void InitCustomer(FINTLCustomerUserProfile &userProfile);

入参说明

名称	类型	说明
userProfile	FINTLCustomerUserProfile	客服模块请求结构体，主要包含语言类型，渠道标识等重要入参

CustomerUserProfile

成员变量	类型	说明	备注
langType	FString	SDK语言，语言类型采用 RFC 4646 标准，如：en，详情请参见 语言类型定义	必填
sign	FString	应用配置	必填
openId	FString	Player Network SDK 用户唯一标识	必填
nickName	FString	角色昵称	必填
gameLevel	FString	游戏等级	选填
roleId	FString	角色 ID，为客服定位问题	选填
areaId	FString	游戏区域 ID，为客服务定位问题	选填
zoneId	FString	游戏区 ID，为客服务定位问题	选填
serverId	FString	游戏服务器 ID，为客服务定位问题	选填
region	string	ISO 3166-1 国家或地区的数字代码 例如 156 代表中国，040 代表奥地利	选填
pictureUrl	FString	头像链接	选填
customParam1	FString	用户标签，数组的字符串，多个标签用", "分隔，默认为空字符串，例如："recharge,suggestion"	选填
customParam2	FString	自定义数据，json字符串，默认为空字符串，例如："{\"level\" : 34,\"total_recharge\" : 300}"	选填
customParam3	FString	未使用的备用参数	选填
customParam4	FString	未使用的备用参数	选填
customParam5	FString	未使用的备用参数	选填

说明

• 当 userProfile 的 langType、sign，openId，nickName 任意一个为空时，将触发 "INVALID_ARGUMENT" 错误，客户端错误码为11。
• 当 H5 请求失败时，将触发 "UNKNOWN" 错误，客户端错误码为 -1。

回调处理

回调处理接口是 CustomerResultObserver。
回调数据结构是 CustomerResult。

回调 ID 是 kMethodIDCustomerInit。

代码示例

FINTLCustomerUserProfile userProfile = new FINTLCustomerUserProfile
(
    "zh-Hans",
    "YOUR_SIGN",
    "openid",
    "1",
    "player1",
    "",
    "",
    "",
    "",
    "",
    "https://head.xxx.com/xx.png",
    "recharge,suggestion",
    "{\"level\" : 34, \"total_recharge\" : 300}"
);
UINTLSDKAPI::InitCustomer(userProfile);