一括インポート/エクスポート ツール を使って、製品の 統計データ と 実績 を管理することができます。このツールは、CSV 形式のデータを含む .zip アーカイブを使用するため、既存のプログラムまたは独自のツールを幅広く使用して、統計データおよび実績の表示および編集が可能になります。
このツールは、統計データと実績の定義のみ影響を与えます。ユーザーの進行状況に対する追加、削除、変更は一切行いません。統計データまたは実績の定義を削除し再作成しても、ユーザーの統計データと実績進行状況はそのまま残ります。
このツールは、デベロッパー ポータル の [ゲームサービス] > [実績] にあります。上部の [Player Lookup (検索)] ボタンと [Create New (実績の作成)] ボタンの間に [一括インポート/エクスポート)] ボタンがあります。
エクスポートする (ステップ 1)
エクスポート処理により、ダウンロード可能な zip アーカイブが作成されます。このアーカイブには、製品のすべての既存の統計データと実績の .csv ファイルと画像ファイルが含まれます。
これらのファイルは標準の .csv 形式に準拠しているので、ほとんどのスプレッドシート ソフトウェア パッケージで簡単にエクスポート/インポートすることができます。画像ファイルはエクスポート前に標準の .png 形式にする必要があります。
[Export Current Achievements (現在の EOS の実績をエクスポートする)] を選択するだけでエクスポートが開始します。自動的にダウンロードが始まり、ダウンロード コンテンツが通常格納される場所に .zip フォルダが作成されます。
[次へ] を選択することで、エクスポートをスキップすることもできます。現在のアーカイブのバックアップがない場合は、このステップをスキップすることは 推奨しません。
インポートする (ステップ 2 とステップ 3)
インポート処理では、エクスポート処理と同じファイル形式を使用します。インポート用の .zip ファイルには、.zip ファイルのルートに次のファイルが含まれていなければなりません。
| ファイル名 | 目次 |
|---|---|
stats.csv | 各統計データを定義する「名前とタイプ」のペアのリスト |
achievementDefinitions.csv | 実績名のリストとそれらが参照する統計データ |
achievementLocalizations.csv | 実績ローカリゼーション ロケール キーとそれらのアイコンのファイル名 |
| One or more .png files | achievementDefinitions.csv で参照されるアイコン |
インポート用に .zip ファイルを準備するために、インポートする .zip テンプレートをアップロードする Developer Portal から .zip テンプレートをダウンロードすることができます (Download EOS Achievements Zip Template を選択します)。または こちら をクリックしてください。いずれの方法でも、適切に編成されたコンテンツを含むサンプル「BulkTemplate.zip」フォルダの自動ダウンロードが開始されます。
インポート処理の開始前に、CSV ファイルと [画像]#アイコンの要件) ファイルの両方の要件を見直してください。
ファイルをインポートする準備ができたら、Bulk Import プロセスのステップ 2 の [Choose File to Upload (アップロードするファイルを選択)] を選択します。インポートによりすべての既存の実績が除去され、製品のすべての統計データがクリアされる注記を確認してください。
[次へ] を選択すると、インポートされたコンテンツに対する検証チェックが始まります。チェックが完了すると、バックエンド サービスはすべての既存の統計データと実績を削除し、zip ファイルの中にあるものに置き換えます。新しい実績がバックエンド サービスで使用するアイコン キャッシュの構築も行われます。
インポート処理の最後に、実績と統計データの成功に関する詳細がモーダルに表示されます。
CSV 形式の要件
アップロードする .csv ファイルが検証チェックに合格するには、各ファイル タイプに対して以下に示されるデータ形式を使用し、空白行を残さないようにします。すべての CSV ファイルは UTF-8 エンコードにする必要があります。
stats.csv 形式
stats.csv ファイルには、1 つの統計データに対して 2 つの列があります。統計データの名前、およびその集計タイプです。集計タイプでサポートされている値は、SUM、MIN、MAX、LATEST です。以下は stats.csvファイルのサンプルです。
詳細については、「「Stats インターフェース」」を参照してください。
achievementDefinitions.csv 形式
achievementsDefinitions.csv は 3 つの列を使用して、それぞれの実績と、実績をロック解除するための要件を定義します。最初の 2 列は、実績の内部名と、実績の表示 / 非表示を示すブール値を保持します。
3 列目はオプションです。空の場合、EOS SDK からの明示的なコマンドによってのみ実績のロック解除が可能です。3 列目 (存在する場合) は、統計データ名としきい値のリストです、次の Achievements.csv ファイルのサンプルが示すように、 Stat1：Threshold1; Stat2：Threshold2; StatN：ThresholdN という形式になります。
詳細については Achievements インターフェース を参照してください。
achievementLocalizations.csv 形式
ユーザーへ表示される実績に関するすべての情報は、ローカリゼーションの対象となります。
achievementLocalizations.csv は、それぞれの実績をさまざまなロケールのユーザーに説明するためにシステムが必要とする、すべてのデータを設定します。含まれるデータは、実績とロケールの内部名、続いてロックされたときのタイトルと説明、ロック解除されたときのタイトルと説明、フレーバー テキスト、ロックされたアイコンとロック解除されたアイコンです。次のサンプル achievementLocalizations.csv ファイルは、同じ実績 セットのデフォルト (2 列目が空) とドイツ語 (2 列目が「de」) バージョンです。
Csv ファイルのロケール (2 番目の) 欄に入力するテキストは以下のタグ形式と一致しなければなりません。
| ロケール | タグ |
|---|---|
Arabic | ar |
Danish | da |
Dutch | nl |
English (America) | en-US |
English (United Kingdom) | en-GB |
Finnish | fi |
French | fr |
German | de |
Italian | it |
Japanese | ja |
Korean | ko |
Norwegian | no |
Polish | pl |
Portuguese (Brazil) | pt-BR |
Russian | ru |
Simplified Chinese | zh-Hans |
Spanish (Mexico) | es-MX |
Spanish (Spain) | es-ES |
Swedish | sv |
Thai | th |
Traditional Chinese | zh-Hant |
Turkish | tr |
2021 年 2 月 23 日、英語 (英国)、スウェーデン語、繁体字中国語、および簡体字中国語のロケールコードが更新されました。この日付けより前に .zip をインポートしないでください。新しいロケールコードと一致するようにこれらのファイルを更新するか、新しくデータをエクスポートしてください。
アイコンの要件
achievementDefinitions.csv で参照するアイコンは、インポートする現在の zip アーカイブに存在する必要があります。これは、それまで存在するすべてのコンテンツが新しいインポート時に消去されるためです。すべてのアイコンは .png 形式であること、そしてアーカイブのルート レベルに存在しなければなりません。.zip ファイルにはサブフォルダを入れないでください。
アイコン ファイル名には、以下の文字を含むことはできません。含まれた場合は Developer Portal エラーが発生します。 \ { ^ } % ` ] > [ ~ < # | & $ @ = 、 : + 、 ? 、スペース ' '
ユーザーが重複してダウンロードするのを防ぐため、実績が同じアイコン ファイルを参照する場合は、アイコンを共有することができます。非表示の実績の「ロックされた」アイコンのように、複数の実績が同じ画像を使用する場合は、この機能を使用してください。