内购接入指南

阅读本文大概需要30分钟

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

创作者的作品将一键发布至233乐园、233派对；233乐园是游戏聚合APP，233派对是扩列与创作的派对游戏并支持创作者作品接入内购。

什么是内购？

应用内付费简称IAP(In-App Purchase)，是一种简单、透明、公平、安全的商业化手段。为创作者创造了可持续发展的条件。使用口袋方舟编辑创作，创作者可通过以下指引接入内购，并根据数据情况优化商业化内容，丰富创作收入来源。

派对币是游戏内的通用货币，100派对币≈1元人民币

内购接入

创建商品

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

该价格为代币价格，目前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);