内购接入指南

阅读本文大概需要30分钟

本文将帮助您快速了解游戏如何创建商品、接入内购、查看内购数据并调优。

平台正在逐步开放完善内购相关功能，您可通过以下指引接入内购，并根据数据情况优化商业化内容，丰富创作收入来源。

内购接入

创建商品

可在【创作者中心】-【我的游戏】-【游戏服务】-【商品管理】创建商品。

该价格为代币价格，目前100代币≈1元，可根据游戏内定价填写合适价格
游戏内的每个商品都应该在游戏维度下的商品管理内创建单独的商品以方便后续管理。

tips：之前创建的商品可以在【创作者中心】-【游戏服务】-【商品管理】修改绑定的游戏

请于6.25前将账号下所有商品绑定游戏，若商品未绑定或并非已绑定游戏，玩家将无法完成支付。请您务必在此之前完成相关内容的修改。

游戏代码编写

代币的数量刷新：

需要在客户端注册代币刷新监听接口

JavaScript

const onArkUpdate = (amount: number) => {
    //刷新逻辑，amount为当前代币数量
}
mw.PurchaseService.onArkBalanceUpdated.add(onArkUpdate);

const onArkUpdate = (amount: number) => {
    //刷新逻辑，amount为当前代币数量
}
mw.PurchaseService.onArkBalanceUpdated.add(onArkUpdate);

需要在商店打开时，在客户端调用代币刷新方法

JavaScript

 mw.PurchaseService.getArkBalance(); // 触发代币余额刷新。接收更新的值要用mw.PurchaseService.onArkBalanceUpdated

 mw.PurchaseService.getArkBalance(); // 触发代币余额刷新。接收更新的值要用mw.PurchaseService.onArkBalanceUpdated

购买代币商品

需要在客户端调用购买方法，并在回调中刷新代币数量，其中CommodityId为平台配置的商品ID

JavaScript

const commodityId = "testId";
const count = 1;
mw.PurchaseService.placeOrder(commodityId, count, (status, msg) => {
    mw.PurchaseService.getArkBalance();//刷新代币数量
});

const commodityId = "testId";
const count = 1;
mw.PurchaseService.placeOrder(commodityId, count, (status, msg) => {
    mw.PurchaseService.getArkBalance();//刷新代币数量
});

需要在服务端注册购买成功回调

JavaScript

const onShipOrder = (playerId: number, orderId: string, commodityId: string, amount: number, confirmOrder: (bReceived: boolean) => void) => {
    //根据playerId和commodityId来处理购买逻辑
    confirmOrder(true);//调用这个方法表示确认收货成功
}
mw.PurchaseService.onOrderDelivered.add(onShipOrder);

const onShipOrder = (playerId: number, orderId: string, commodityId: string, amount: number, confirmOrder: (bReceived: boolean) => void) => {
    //根据playerId和commodityId来处理购买逻辑
    confirmOrder(true);//调用这个方法表示确认收货成功
}
mw.PurchaseService.onOrderDelivered.add(onShipOrder);