跳到主要内容

初始化客服(InitCustomer)

AndroidiOSWindows
如果您使用的是 Unreal Engine,请参见 Unreal Engine SDK 的 InitCustomer

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

函数定义

public void InitCustomer(INTLCustomerUserProfile userProfile);

入参说明

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

CustomerUserProfile

成员变量类型说明备注
langTypestringSDK语言,语言类型采用 RFC 4646 标准,如:en,详情请参见 语言类型定义必填
signstring应用配置必填
openIdstringPlayer Network SDK 用户唯一标识必填
nickNamestring角色昵称必填
gameLevelstring游戏等级选填
roleIdstring角色 ID,为客服定位问题选填
areaIdstring游戏区域 ID,为客服务定位问题选填
zoneIdstring游戏区 ID,为客服务定位问题选填
serverIdstring游戏服务器 ID,为客服务定位问题选填
regionstringISO 3166-1 国家或地区的数字代码
例如 156 代表中国,040 代表奥地利
选填
pictureUrlstring头像链接选填
customParam1string用户标签,数组的字符串,多个标签用", "分隔,默认为空字符串,例如:"recharge,suggestion"选填
customParam2string自定义数据,json字符串,默认为空字符串,例如:"{\"level\" : 34,\"total_recharge\" : 300}"选填
customParam3string未使用的备用参数选填
customParam4string未使用的备用参数选填
customParam5string未使用的备用参数选填
说明
  • userProfilelangTypesignopenIdnickName 任意一个为空时,将触发 "INVALID_ARGUMENT" 错误,客户端错误码为11。
  • 当 H5 请求失败时,将触发 "UNKNOWN" 错误,客户端错误码为 -1。

回调处理

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

回调 ID 是 INTL_CUSTOMER_INIT

代码示例

var userProfile = new INTLCustomerUserProfile
{
LangType = "zh-Hans",
Sign = "YOUR_SIGN",
OpenId = "openid",
GameLevel = "1",
NickName = "player1",
RoleId = "",
AreaId = "",
ZoneId = "",
ServerId = "",
Region = "",
PictureUrl = "https://head.xxx.com/xx.png",
CustomParam1 = "recharge,suggestion",
CustomParam2 = "{\"level\" : 34, \"total_recharge\" : 300}"
};
INTLAPI.InitCustomer(userProfile);