跳到主要内容

礼包配置

如本文所述，LI PASS 礼包功能支持两种场景：绑定礼包和首次登录礼包。LI PASS 的礼包接口只确定玩家是否有资格获得礼包；具体的礼包内容和礼包发放由其他团队管理。请联系您的业务接口人配置礼包活动，礼包发货链路，及游戏内的礼包资源位。

LI PASS 接口​

绑定礼包​

该逻辑已在 LI PASS 账号中心实现，无需调用额外接口，在礼包实现后可直接进行验收。

首次登录礼包​

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

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

注意

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

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

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

JSON 字符串格式为：

{
    "area_id":xx,     //int type
    "role_id":"xx",   //string type
    "plat_id":×x,     //int type
    "zone_id":××      //int type
}

处理礼包活动​

  1. 添加/移除 AuthBaseResultObserver
  2. 添加/移除 LIEventObserver

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

礼包实现​

1. 确认礼包发放接口​

联系技术接口人配置 IDIP 和 LI PASS 后台接口，确保玩家成为 LI PASS 用户后可以顺畅收到礼包奖励。

IDIP 接口人：havenni(倪海文)

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

礼包活动配置平台有 Game Events 和 AMS（新业务推荐使用AMS），确认平台后可以在该平台配置礼包活动。如果业务未接入任一平台，则需要先接入平台，确认活动平台和发货接口打通后，再配置礼包活动。

GameEvents接入联系人：fuyihuang

AMS接入联系人：eagleyin

3. 确认礼包内容​

GameEvents 和 AMS 活动配置都是以礼包／道具为依赖，所以最好事先确认礼包内容；如果暂时无法确认，可以使用测试道具配置测试活动，确保发奖链路通顺后，重新配置正式礼包活动。

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

确认游戏内公告资源位，进行公告图设计并配置公告、活动。如需 LI PASS 团队协助 UI 设计，请联系 [jiaren] 对接及排期（涉及排期，建议业务侧在游戏上线前2个月发起沟通）。

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

将礼包活动配置信息及对应平台提供给到账号联调团队，进行内部接口相关调试，调试成功后使用业务包进行发货链路联调，此处需要联调同学／账号后台／业务研发／活动平台开发几方配合联动，确保礼包到账链路通顺。

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

最后于 更新