引き換えコード

引き換えコード機能は、Jogos プラットフォームが開発者に代わってゲーム内の全ての CDkey の発行と使用状況を管理します。ただし、ゲーム内の報酬やアイテムの発行管理は行いません。

引き換えコードの作成

開発者は自身で使用可能な CDkey を生成し、生成した CDkey を開発者バックエンドにアップロードします。

CDkey には 2 種類のタイプがあります:

• 共通コード: 1 つの CDkey のみを入力。全てのプレイヤーが同じコードを使用して同じ報酬と引き換えることができ、各プレイヤーは 1 回のみ使用可能。
• ユニークコード: 複数の CDkey をアップロード必要があります。1 つのコードは誰が使用しても、1 回しか使用できません。

Jogos プラットフォームは、アップロードされた CDkey の数、配布状況、使用状況、有効期限の管理を行います。

CDkey を配布するチャネル:

• プレイヤーが無料で獲得: 各ユーザーはゲーム詳細ページで受け取ることも、動画広告視聴中に確率で受け取ることも可能。
• プラットフォームイベントに伴う: ユーザーがプラットフォームのイベントに参加し、条件付きで受け取る。

引き換えコードの検証と報酬の付与

ログインユーザーがイベント参加或其他の方法で引き換えコードを取得した後、Jogos はゲーム内で受け取った CDkey をコピーする機能を提供します。ユーザーはコピー後、ゲーム内で使用します。

景品引き換えの処理

• 開発者は、ユーザーが引き換えコードを入力して報酬を受け取れるようにするための入力欄を提供する必要があります。
• あなたのゲーム（ゲームサーバーがない場合）は、このインターフェースを呼び出して、ユーザーが所持しているか、使用済みか、有効期限切れかを検証することを推奨します。
• インターフェースの返却結果に基づき、ゲーム内で報酬の付与処理、または使用異常の通知メッセージを表示します。
• リクエストされたCDKeyの内容に応じて、あなたのゲームが対応する付与するアイテムや報酬の処理を自行で行う必要があります。

/**
 * 景品を交換する
 * @param cdkey 引き換えコード
 */
await window.JOGOS_SDK.game.exchangePrizes(cdkey: string);