実績を統合する

実績を作成する

新しい未公開のゲームの実績を作成するには:

1. Google Play Console でゲームを選択します。
2. [Play Games サービス - 実績] ページ（[成長] > [Play Games サービス] > [設定と管理] > [実績]）で、[実績を作成] を選択します。
3. [実績を追加] ページで、フォームに入力します。
4. [未公開として保存] をクリックします。
5. 実績の作成を完了したら、実績を公開する必要があります。

実績のインポート

ゲームに複数の実績を一度に追加するには:

1. 実績を含む ZIP ファイルを作成します。
2. ファイルをアップロードします。

ZIP ファイルについて詳しくは、ZIP ファイルのガイドラインをご覧ください。

実績をインポートするには:

1. Google Play Console でゲームを選択します。
2. [Play Games サービス - 実績] ページ（[成長] > [Play Games サービス] > [設定と管理] > [実績]）で、[実績をインポート] を選択します。
3. [実績のインポート] ページで、[アップロード] をクリックします。
4. アップロードする ZIP ファイルを選択します。
5. [未公開として保存] をクリックします。
6. 実績のインポートを完了したら、ゲームを公開する必要があります。

ZIP ファイルのガイドライン

ZIP ファイルを使用して複数の実績を一度にインポートできます。ZIP ファイルで使用する正確なファイル名については、以下の表をご覧ください。

ZIP ファイルの要件:

• サブディレクトリがない。
• 一意のファイル名。
• CSV、PNG、JPEG、JPG 形式のファイルのみ。
• CSV ファイルにヘッダー行を含めることはできません。
• 各ファイルのサイズを 1 MB 未満にする必要がある。
• ZIP ファイル内のファイル数は 203 個以下にしてください。
• ZIP ファイルの合計サイズは 200 MB 未満にする必要がある。

AchievementsMetadata.csv 形式

AchievementsMetadata.csv ファイルには、各実績のメタデータが含まれます。情報はカンマ区切り値として、次の順序で指定する必要があります。

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

各フィールドについては、以下の表をご覧ください。

AchievementsMetadata.csv ファイルの要件:

• 各行には 7 つの値が必要です。値を省略する場合は、空白にします。
• Name フィールドと Description フィールドは、デフォルトの言語 / 地域として使用されます。
• Name フィールドは、すべての実績で一意にする必要があります。
• Name と Description のフィールドにはカンマを入れないでください。

AchievementsMetadata.csv ファイルのサンプル:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

AchievementsLocalizations.csv 形式

AchievementsLocalizations.csv ファイルは省略可能です。各実績をさまざまな言語 / 地域のユーザーに説明するために必要なすべてのデータを設定します。実績は、ゲームに指定された言語 / 地域に合わせて翻訳されます。

情報はカンマ区切り値として、次の順序で指定する必要があります。

   Name, Localized name, Localized description, locale

各フィールドについては、以下の表をご覧ください。

AchievementsLocalizations.csv ファイルの要件:

• ゲーム内のアチーブメントの名前は言語 / 地域ごとに一意である必要があります。

  たとえば、ゲームが en-US と fr-FR の両方の言語 / 地域コードをサポートしている場合、en-US で「Achievement1」という名前の実績には、fr-FR でも「Achievement1」という名前を付けることができます。

• 各行に 4 つの値が必要です。「Localized description」の値を省略する場合は、空白のままにします。

AchievementsLocalizations.csv ファイルのサンプル:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

AchievementsIconMappings.csv 形式

AchievementsIconMappings.csv ファイルは省略可能です。実績を所定のアイコンとマッピングする場合に使用します。情報はカンマ区切り値として、次の順序で指定する必要があります。

Name, icon filename

これらのフィールドについては、次の表をご覧ください。

AchievementsIconMappings.csv ファイルの要件:

• 各行に 2 つの値が必要です。
• アイコン ファイルとして指定できるのは、PNG 形式または JPEG 形式のみです。

AchievementsIconMappings.csv ファイルのサンプル:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

アイコンのガイドライン

アイコンは、512 x 512 の PNG、JPEG、または JPG ファイルとして作成する必要があります。提供する必要があるアイコンは、ロックが解除された実績のアイコンのみです。表示のアイコンについてはグレースケール バージョンが自動的に生成されます。そのため、表示されている実績とロックが解除された実績とをユーザーが区別できるよう、実績のアイコンにはカラフルな要素を取り入れることをおすすめします。

Android の [トースト][a] で実績アイコンを表示すると、アイコンは円で囲まれ、外側の角は表示されなくなります。このような状態でも、アイコンがきれいに表示されることを確認してください。

すべての言語 / 地域で同じアイコンが使用されるため、アイコンにテキストやローカライズされたコンテンツを含めることはおすすめしません。

アイコン ファイル

AchievementsIconMappings.csv ファイルで参照するアイコンは、インポートする現在の ZIP アーカイブに含まれている必要があります。

実績を編集する

既存の実績がすでにあり、編集するには:

1. Google Play Console でゲームを選択します。
2. [Play Games サービス - 実績] ページ（[成長] > [Play Games サービス] > [設定と管理] > [実績]）で、実績を選択します。
3. 任意のフィールドを編集できます。
4. [未公開として保存] をクリックします。
5. [Play Games サービス - 実績] ページで、編集した実績のステータスが [テスターが利用可能] になっています。
6. アチーブメントをテストしたら、[確認して公開] をクリックします。

   これにより、編集したすべての実績とともにゲームが再公開されます。

実績を削除する

いったん公開した実績は削除できません。削除できるのは公開前の状態の実績のみです

1. [Play Games サービス - 実績] ページで、実績を選択します。
2. アチーブメントを削除するには、[アチーブメントを削除] をクリックします。

実績をリセットする

未公開の実績であれば、プレーヤーの進行状況のデータをリセットできます。

1. [Play Games サービス - 実績] ページで、実績を選択します。
2. 実績をリセットするには、[進行状況をリセット] をクリックします。
3. 実績データをプログラムでリセットするには、Management API の Achievements メソッドを呼び出します。