礼包接入

本页旨在帮助业务快速、顺利地接入 LI PASS 的礼包发奖功能。礼包功能涉及多方协作，请按流程逐步完成。

LI PASS 礼包功能支持两种场景：绑定礼包和首次登录礼包。

LI PASS 的礼包接口只确定玩家是否有资格获得礼包，具体的礼包内容和礼包发放由其他团队管理。请联系您的业务接口人配置礼包活动，礼包发货链路，及游戏内的礼包资源位。

前往礼包产品文档了解更多。

LI PASS 接口

绑定礼包

该逻辑已在 LI PASS 账号中心实现，游戏侧只需在有角色信息的情况下进入大厅时调用 SetRewardExtraJson 接口设置 extraJson，无需调用 SendBindReward，在礼包实现后可直接进行验收。

如需为玩家发放首次登录礼包，在玩家进入游戏大厅后调用 SetRewardExtraJson 接口，然后调用 SendBindReward 接口。LI PASS 的礼包服务将自动检查玩家是否符合礼包发放要求，然后为符合要求的玩家发放礼包。

SetRewardExtraJson 接口的入参为符合 IDIP 协议规定的 JSON 字符串。SendBindReward 接口的入参则为一个代表礼包活动 ID 的字符串和一个符合 IDIP 协议规定的 JSON 字符串。

note

建议在调用 SetRewardExtraJson 接口时添加 JSON 格式校验。需要传入标准 JSON 格式，否则会出现兼容报错。

要获取代表礼包活动 ID 的字符串，请联系 Player Network 助手。

Unity
Unreal Engine

INTLAPI.SetRewardExtraJson("{}");
INTLAPI.SendBindReward("110001", "{}");

UINTLSDKAPI::SetRewardExtraJson("{}");
UINTLSDKAPI::SendBindReward("110001", "{}");

JSON 字符串格式为：

{
    "area_id":xx,     //int type (idip侧获取的 area 所在大区id)
    "role_id":"xx",   //string type (游戏侧的roleId 角色id)
    "plat_id":×x,     //int type (idip侧获取的 platid 平台)
    "zone_id":××      //int type (idip侧获取的 partition 分区)
}

处理礼包活动

Unity
Unreal Engine

添加/移除 AuthBaseResultObserver
添加/移除 LIEventObserver

AuthResult 和 LIBaseEventResult 等数据结构包含登录信息。获取登录信息，请参见 AuthResultObserver 和 LIEventObserver。

礼包实现

1. 确认礼包发放接口

业务侧需确认具备 IDIP 发奖接口通道，以确保玩家成为 LI PASS 用户后可正常接收礼包。

IDIP 接口人：havenni(倪海文)

2. 确认礼包活动配置平台

业务侧需确认礼包活动平台与发货接口已打通（LI PASS 活动发奖支持 AMS 平台），然后再确认礼包内容及配置礼包活动单。

AMS 接入联系人：eagleyin

3. 确认礼包内容

AMS 活动以礼包/道具为基本单位，需提前明确礼包内容。若暂未确定，可先用测试道具配置测试活动，待发奖链路通畅后替换为正式礼包。

联系 Player Network 助手配置 LI PASS 后台发奖接口，需提供以下信息：

道具 ID（需为角色绑定类型）
道具名称（如有多语言，需提供各语言版本并注明默认语言）
道具数量
AMS 礼包活动单（如有多语言邮件设置，需提供各语言版本并注明默认语言）

如业务方需协助配置活动礼包单，请联系 Player Network助手。

注意：道具 icon 无需在活动礼包单中配置，需游戏侧与 AMS 平台确认具体所需字段。

4. 确认【LI PASS 绑定指引】资源位

业务侧需确认游戏内公告资源位（如拍脸公告、通知公告、活动位、官网通知等），并根据投放位置调整视觉风格、文案语气与尺寸。

如需 LI PASS 团队协助 UI 设计，请联系 Player Network助手对接及排期（涉及排期，建议业务侧在游戏上线前2个月发起沟通）。

需提供以下材料：

尺寸、规范、模板
游戏素材
公告文本（多语言版本+默认语言）
活动入口信息

5. 礼包活动联调及验收

确认礼包发放能力及配置、游戏已接入客户端发奖接口，将礼包活动配置信息提供给到账号联调团队，进行 LI PASS 后台发奖接口调试，调试成功后使用业务包进行发货链路联调，此处需要联调同学／账号后台／业务研发／活动平台开发几方配合联动，确保礼包到账链路通顺。

游戏上线前测试需要包含礼包到账联路测试，LI PASS 团队可以提供测试用例，需要可联系 Player Network助手。

注意：游戏侧需要确认不同场景下传入的 SetRewardExtrajson 是当前最新的玩家区服和角色信息。

LI PASS 接口​

绑定礼包​

首次登录礼包​

处理礼包活动​

礼包实现​

1. 确认礼包发放接口​

2. 确认礼包活动配置平台​

3. 确认礼包内容​

4. 确认【LI PASS 绑定指引】资源位​

5. 礼包活动联调及验收​