内购接入指南

阅读本文大概需要30分钟

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

什么是内购？

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

派对币

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

内购接入

创建商品

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

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

游戏代码编写

代币的数量刷新

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

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);