隠し実績を設定する

Last updated on October 14, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Gaming Services (AGS) の実績サービスを使用すると、隠し実績を設定できます。隠し実績は、ロックされている間はプレイヤーに表示されない実績です。通常は秘密として扱われ、ロック解除されるまでプレイヤーには公開されません。

このガイドでは、可視性オプションを利用して、AGS 管理ポータルまたは AGS CLI で隠し実績を設定する方法を学習します。

目標

• 実績設定の概要を理解する。
• 隠し実績の設定で可視性オプションを活用する方法を理解する。

前提条件

• AGS 管理ポータルへのアクセス。
• AccelByte Achievement API ドキュメントへのアクセス。
• 必要な情報を設定するための AccelByte Statistics API へのアクセス(オプション)。

• AGS CLI の手順を実行するには、AGS CLI をインストールし、これらの機能へのアクセス権を持つアカウントでサインインしておく必要があります。詳細はインストールとサインインを参照してください。例では Bash シェルを使用しています。

隠し実績を設定する

隠し実績は、段階型と非段階型のどちらにするかを柔軟に選択できるよう、ユーザー統計の追跡に依存しない設計になっています。段階型にする場合は、ゲーム全体のグローバル統計を追跡するガイドに従って、追跡対象の属性を保存する統計設定を作成できます。

以下の手順に従って、AGS 管理ポータルまたは AGS CLI で実績を設定できます。

Admin Portal

1. 管理ポータルのサイドバーで、Online > Achievements > Configuration に移動します。

2. Achievements ページで、Add Achievement ボタンをクリックします。

3. Add New Achievements フォームで、必要な情報を入力します。

4. Code フィールドに、許可された形式の識別子(例: hero-collector)を入力します。また、後から実績を識別しやすくするために、実績の Name を入力します。作成した実績に関する補足情報を示すため、Description も入力してください。

2. 段階型実績の場合は Incremental ボックスをオンにし、非段階型実績の場合はオフのままにします。段階型実績を作成する場合は、この実績に関連付ける統計の Goal Value と Statcode を入力します。

3. 隠し実績にするには、Visibility が Hidden に設定されていることを確認します。

4. Locked Icon の画像を追加します。このアイコンは、まだこの実績を獲得していないプレイヤーに表示されます。
5. 実績がロック解除されたときに表示される Unlocked Icon を追加します。
6. Tags や Custom Attributes など、実績の補足情報を保存できるオプションフィールドもあります。

4. Add をクリックします。新しい実績が実績リストに追加されます。

AGS CLI

1. 実績の設定を記述した JSON ファイルを作成します。ファイル名は任意です。この例では achievement.json を使用します。

   {
     "achievementCode": "<AchievementCode>",
     "defaultLanguage": "en",
     "name": { "en": "<AchievementName>" },
     "description": { "en": "<AchievementDescription>" },
     "hidden": true,
     "incremental": false,
     "lockedIcons": [{ "slug": "<LockedIconName>", "url": "<LockedIconUrl>" }],
     "unlockedIcons": [{ "slug": "<UnlockedIconName>", "url": "<UnlockedIconUrl>" }]
   }

   • achievementCode、name、description: それぞれ Code、Name、Description に対応します。name と description には言語ごとに 1 つずつテキストを指定し、defaultLanguage にはそれらの言語のいずれかを指定する必要があります。
   • hidden: 隠し実績の場合は true に設定します。
   • incremental: 非段階型実績の場合は false に設定します。段階型実績の場合は true に設定し、statCode と goalValue(1 以上)を追加して、それぞれ Statcode と Goal Value を指定します。
   • lockedIcons と unlockedIcons: それぞれ Locked Icon と Unlocked Icon に対応します。管理ポータルでは画像が自動的にアップロードされます。AGS CLI では、url にホスト済みの画像のアドレスを、slug にアイコンの名前を指定します。

   その他のフィールドを設定するには、ファイルに追加します。すべてのフィールドを確認するには、ags achievement achievements create --skeleton を実行します。次のフィールドは、管理ポータルのオプション設定に対応しています。

   管理ポータルの設定	リクエストボディのフィールド
   Tags	tags
   Custom Attributes	customAttributes

2. 実績を作成します。@ の後に JSON ファイルのパスを指定します。

   ags achievement achievements create --namespace <YourNamespace> --json @achievement.json

   コマンドを実行すると、作成された実績が出力されます。

次のステップ

隠し実績を設定したら、ゲームへの統合を開始できます。次の記事を参照してください。

• AGS SDK を使用してプレイヤーの実績を表示する
• AGS SDK を使用してプレイヤーの実績をロック解除する
• 管理ポータルからプレイヤーの実績を管理する
• 実績をグループ化およびフィルタリングする

実績サービスは、段階型実績とグローバル実績の設定もサポートしています。