跳到主要内容

初始化客服（InitCustomer）

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

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

函数定义​

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

入参说明​

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

CustomerUserProfile​

成员变量类型说明备注
langTypeFStringSDK语言，语言类型采用 RFC 4646 标准，如：en，详情请参见 语言类型定义必填
signFString应用配置必填
openIdFStringPlayer Network SDK 用户唯一标识必填
nickNameFString角色昵称必填
gameLevelFString游戏等级选填
roleIdFString角色 ID，为客服定位问题选填
areaIdFString游戏区域 ID，为客服务定位问题选填
zoneIdFString游戏区 ID，为客服务定位问题选填
serverIdFString游戏服务器 ID，为客服务定位问题选填
regionstringISO 3166-1 国家或地区的数字代码
例如 156 代表中国，040 代表奥地利		选填
pictureUrlFString头像链接选填
customParam1FString用户标签，数组的字符串，多个标签用", "分隔，默认为空字符串，例如："recharge,suggestion"选填
customParam2FString自定义数据，json字符串，默认为空字符串，例如：{"level": 34, "total_recharge": 300}选填
customParam3FString未使用的备用参数选填
customParam4FString未使用的备用参数选填
customParam5FString未使用的备用参数选填
说明
  • 当 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);