あなたの世界を作りなさい
経済
ギフティングAPI
10 分
zepeto world内の他のユーザーに衣服アイテムを贈るために、ギフティングapiを使用できます。 ただし、apiを使用する際には、送信者のアイテムが差し引かれます。 インストール ウィンドウ → パッケージマネージャー → zepeto worldパッケージを最初にバージョン1 21 14以上をインストールしてください。 その後、バージョン1 0 7以上の‘zepeto module’パッケージをインストールしてください。 zepetoアプリがバージョン3 46 000以上で動作していることを確認してください。 ギフティングapi ギフティングapiを使用するには、以下のインポート文を追加してください。 import { giftbackgroundtype, shopservice, itemgiftresponse } from 'zepeto module shop'; ギフティングapiに興味がある場合は、ドキュメントを参照してください: 📘 次のガイドを参照してください。 \[ zepeto module shop api https //developer zepeto me/docs/module/namespaces/zepeto module shop ] unityエディタでは、成功と失敗の両方のケースをテストできます。ギフティングが成功しても、通貨は差し引かれず、ギフトは受取人に配信されません。 qrコードやテストリンクを介したモバイルテスト中に、成功した取引は実際の通貨の差し引きが行われ、ギフトは受取人に配信されます。 使用例 キャンバスにギフト送信ボタンを追加してください。 以下のようにサンプルコードを書いてください。 import { zepetoscriptbehaviour } from 'zepeto script'; import { giftbackgroundtype, shopservice, itemgiftresponse } from 'zepeto module shop'; import { button } from 'unityengine ui'; import { errorcode } from 'zepeto module'; export default class sendgift extends zepetoscriptbehaviour { public itemid string; public targetuserid string; public sendgiftbutton button; start() { this sendgiftbutton onclick addlistener(()=>{ shopservice showgiftpopup( this itemid, this targetuserid, giftbackgroundtype type01, "こんにちは、これはあなたのためです!", (response itemgiftresponse) => { // oncomplete コールバック console log(`ギフトが正常に送信されました! zepetoコイン残高 ${response coin}, zem残高 ${response zem}`); }, (error errorcode) => { // onfailure コールバック console error("ギフト送信エラー ", error); } ); }); } } スクリプトを書いた後、インスペクターでボタンを接続し、ギフトを受け取る人のユーザーidとアイテムidを入力してください。 📘 zepeto playerのuseridを取得する方法については、以下のガイドを参照してください。 \[ zepetoプレーヤー docid 2xtlbty9qgzwgthyv8nxs ] 成功または失敗のケースをテストするために、qrコードを作成し、モバイルデバイスでテストしてください。 ただし、送信者の商品の金額が差し引かれることに注意してください。 ギフト送信が成功したとき ボタンをクリックすると、ギフト送信のためのポップアップuiが表示されます。 ギフトが正常に送信された場合、成功を示すトーストuiが表示され、サンプルスクリプトがログを生成します。 さらに、targetuserのためのギフトが届きました。 ギフト送信の失敗 ケースがerrorcodeに該当する場合、エラーメッセージがtoast uiに表示され、サンプルスクリプトが対応するエラーコードを出力します。