礼包码

Combo SDK 提供了礼包码兑换功能，支持游戏客户端自行实现礼包码兑换 UI 进行兑换和使用 Combo SDK WebView 礼包码兑换页面进行兑换两种应用场景。游戏可按需选择上述应用场景，详情请查看 RedeemGiftCodeOptions。兑换成功后，将通过世游 GM 平台 给用户发送游戏内角色邮件，并携带附件奖励。

提示

• 礼包码的生成、管理以及用户兑换记录，可通过世游发行平台进行操作、查看。
• 礼包码兑换页面链接由世游运营团队在世游发行平台进行配置，无需游戏侧处理。

支持平台

方法签名

public static void RedeemGiftCode(RedeemGiftCodeOptions opts, Action<Result<RedeemGiftCodeResult>> callback);

代码示例

Show Code

var opts = new RedeemGiftCodeOptions()
{
    ServerId = 10001,
    RoleId = "角色 ID",
    RoleName = "角色名称",
    // 游戏自行实现 UI 时，需要传入 GiftCode 字段
    GiftCode = "GiftCode",
    Width = 100,
    Height = 100
};

ComboSDK.RedeemGiftCode(opts, r => {
    if(r.IsSuccess)
    {
        // TODO: 礼包码兑换流程结束后处理
    }
    else
    {
        var error = r.Error;
        Debug.LogError("礼包码兑换失败：" + error.DetailMessage)
    }
});

方法参数

Parameters	Required	Type	Description
opts	True	RedeemGiftCodeOptions	打开礼包码兑换页面所需传入的参数集
callback	True	Action<Result<RedeemGiftCodeResult>>	礼包码兑换流程结束后的回调方法，当礼包码兑换页面成功打开时，会在用户关闭页面时返回

RedeemGiftCodeOptions

Parameters	Required	Type	Description
ServerId	True	int	游戏服务器 ID
RoleId	True	string	游戏角色 ID
RoleName	False	string	游戏角色名
GiftCode	False	string	礼包码
Width	False	int	礼包码兑换页面宽度占屏幕宽度的百分比，取值范围为 (0,100]
Height	False	int	礼包码兑换页面高度占屏幕高度的百分比，取值范围为 (0,100]

提示

• 若游戏客户端自行实现礼包码兑换 UI，请传入 GiftCode 字段，SDK 将直接使用该值进行奖励兑换。
• 若不传入 GiftCode，则将打开礼包码兑换 WebView 页面，用户在页面中输入礼包码，即可兑换奖励。
• Width 和 Height 若不在取值范围内，则使用 SDK 内部的默认显示策略。

RedeemGiftCodeResult

Properties	Supported Platforms	Type	Description

Error

Code	Supported Platforms	Description
INVALID_GIFT_CODE_URL		兑换礼包码页面地址错误
NETWORK_ERROR		网络错误
SERVER_ERROR		服务端错误
UNKNOWN_ERROR		未知错误

提示

错误处理请参阅。