Bulk Importer and Exporter

スタッツおよびアチーブメント管理を支援するツールです。

6 分で読めます

Bulk Importer/Exporter Tool を使って、製品の スタッツアチーブメント を管理することができます。このツールは、CSV 形式のデータを含む .zip アーカイブを使用するため、既存のプログラムまたは独自のツールを幅広く使用して、スタッツおよびアチーブメントの表示および編集が可能になります。

このツールは、スタッツとアチーブメントの定義のみ影響を与えます。ユーザーの進行状況に対する追加、削除、変更は一切行いません。スタッツまたはアチーブメントの定義を削除し再作成しても、ユーザーのスタッツとアチーブメント進行状況はそのまま残ります。

このツールは、Developer Portal[Games Services] > [Achievements] にあります。上部の [Player Lookup] ボタンと [Create New] ボタンの間に [Bulk Import/Export] ボタンがあります。

エクスポートする (ステップ 1)

エクスポート処理により、ダウンロード可能な zip アーカイブが作成されます。このアーカイブには、製品のすべての既存のスタッツとアチーブメントの .csv ファイルと画像ファイルが含まれます。

これらのファイルは標準の .csv 形式に準拠しているので、ほとんどのスプレッドシート ソフトウェア パッケージで簡単にエクスポート/インポートすることができます。画像ファイルはエクスポート前に標準の .png 形式にする必要があります。

[Export Current Achievements (現在のアーカイブをエクスポートする)] を選択するだけでエクスポートが開始します。自動的にダウンロードが始まり、ダウンロード コンテンツが通常格納される場所に .zip フォルダが作成されます。

[Next] を選択することで、エクスポートをスキップすることもできます。現在のアーカイブのバックアップがない場合は、このステップをスキップすることは 推奨しません

インポートする (ステップ 2 とステップ 3)

インポート処理では、エクスポート処理と同じファイル形式を使用します。インポート用の .zip ファイルには、.zip ファイルのルートに次のファイルが含まれていなければなりません。

ファイル名目次
stats.csv各スタッツを定義する「名前とタイプ」のペアのリスト
achievementDefinitions.csvアチーブメント名のリストとそれらが参照するスタッツ
achievementLocalizations.csvアチーブメント ローカリゼーション ロケール キーとそれらのアイコンのファイル名
One or more .png filesachievementDefinitions.csv で参照されるアイコン

インポート用に .zip ファイルを準備するために、インポートする .zip テンプレートをアップロードする Developer Portal から .zip テンプレートをダウンロードすることができます (Download EOS Achievements Zip Template を選択します)。または こちら をクリックしてください。いずれの方法でも、適切に編成されたコンテンツを含むサンプル「BulkTemplate.zip」フォルダの自動ダウンロードが開始されます。

Sample of the EOS Achievements Bulk Import template

インポート処理の開始前に、CSV ファイルと [画像]#アイコンの要件) ファイルの両方の要件を見直してください。

ファイルをインポートする準備ができたら、Bulk Import プロセスのステップ 2 の [Choose File to Upload (アップロードするファイルを選択)] を選択します。インポートによりすべての既存のアチーブメントが除去され、製品のすべてのスタッツがクリアされる注記を確認してください。

[Next] を選択すると、インポートされたコンテンツに対する検証チェックが始まります。チェックが完了すると、バックエンド サービスはすべての既存のスタッツとアチーブメントを削除し、zip ファイルの中にあるものに置き換えます。新しいアチーブメントがバックエンド サービスで使用するアイコン キャッシュの構築も行われます。

インポート処理の最後に、アチーブメントとスタッツの成功に関する詳細がモーダルに表示されます。

CSV 形式の要件

アップロードする .csv ファイルが検証チェックに合格するには、各ファイル タイプに対して以下に示されるデータ形式を使用し、空白行を残さないようにします。すべての CSV ファイルは UTF-8 エンコードにする必要があります。

stats.csv 形式

stats.csv ファイルには、1 つのスタッツに対して 2 つの列があります。スタッツの名前、およびその集計タイプです。集計タイプでサポートされている値は、SUMMINMAXLATEST です。以下は stats.csvファイルのサンプルです。

name,aggregationType
numTreesChopped,SUM
lastTreesChopped,LATEST
maxTreesChopped,MAX
minTreesChopped,MIN
numAxesUsed,SUM

詳細については「Stats Interface」を参照してください。

achievementDefinitions.csv 形式

achievementsDefinitions.csv は 3 つの列を使用して、それぞれのアチーブメントと、アチーブメントをロック解除するための要件を定義します。最初の 2 列は、アチーブメントの内部名と、アチーブメントの表示 / 非表示を示すブール値を保持します。

3 列目はオプションです。空の場合、EOS SDK からの明示的なコマンドによってのみアチーブメントのロック解除が可能です。3 列目 (存在する場合) は、スタッツ名としきい値のリストです、次の Achievements.csv ファイルのサンプルが示すように、 Stat1:Threshold1; Stat2:Threshold2; StatN:ThresholdN という形式になります。

name,hidden,statThresholds
achvTutorial,FALSE,
achvLumberjack,FALSE,numTreesChopped:3
achvWoodsman,TRUE,numTreesChopped:100;numAxesUsed:5

詳細については Achievements インターフェース を参照してください。

achievementLocalizations.csv 形式

ユーザーへ表示されるアチーブメントに関するすべての情報は、ローカリゼーションの対象となります。

achievementLocalizations.csv は、それぞれのアチーブメントをさまざまなロケールのユーザーに説明するためにシステムが必要とする、すべてのデータを設定します。含まれるデータは、アチーブメントとロケールの内部名、続いてロックされたときのタイトルと説明、ロック解除されたときのタイトルと説明、フレーバー テキスト、ロックされたアイコンとロック解除されたアイコンです。次のサンプル achievementLocalizations.csv ファイルは、同じアチーブメント セットのデフォルト (2 列目が空) とドイツ語 (2 列目が「de」) バージョンです。

name,locale,lockedTitle,lockedDescription,unlockedTitle,unlockedDescription,flavorText,lockedIcon,unlockedIcon
achvTutorial,,Intro,Complete the Tutorial,Intro,Completed the Tutorial,Onwards!,locked.png,tutorial.png
achvTutorial,de,Einführung,Schließe die Einführung ab,Einführung,Die Einführung abgeschlossen,Weiter!,locked.png,tutorial.png
achvLumberjack,,Lumberjack,Chop 3 trees,Lumberjack,Chopped 3 trees,Timber!,locked.png,lumberjack.png
achvLumberjack,de,Holzfäller,Fälle drei Bäume,Holzfäller,Drei Bäume gefällt,Holz!,locked.png,lumberjack_de.png
achvWoodsman,,Woodsman,Roam the woods,Woodsman,Travelled the woods and chopped some trees,,lockedSecret.png,woodsman.png
achvWoodsman,de,Waldmensch,Durschtreife die Wälder,Waldmensch,Die Wälder bereist und Bäume gefällt,,lockedSecret.png,woodsman.png

Csv ファイルのロケール (2 番目の) 欄に入力するテキストは以下のタグ形式と一致しなければなりません。

ロケールタグ
Arabicar
Danishda
Dutchnl
English (America)en-US
English (United Kingdom)en-GB
Finnishfi
Frenchfr
Germande
Italianit
Japaneseja
Koreanko
Norwegianno
Polishpl
Portuguese (Brazil)pt-BR
Russianru
Simplified Chinesezh-Hans
Spanish (Mexico)es-MX
Spanish (Spain)es-ES
Swedishsv
Thaith
Traditional Chinesezh-Hant
Turkishtr

2021 年 2 月 23 日、英語 (英国)、スウェーデン語、繁体字中国語、および簡体字中国語のロケールコードが更新されました。この日付けより前に .zip をインポートしないでください。新しいロケールコードと一致するようにこれらのファイルを更新するか、新しくデータをエクスポートしてください。

アイコンの要件

achievementDefinitions.csv で参照するアイコンは、インポートする現在の zip アーカイブに存在する必要があります。これは、それまで存在するすべてのコンテンツが新しいインポート時に消去されるためです。すべてのアイコンは .png 形式であること、そしてアーカイブのルート レベルに存在しなければなりません。.zip ファイルにはサブフォルダを入れないでください。

アイコン ファイル名には、以下の文字を含むことはできません。含まれた場合は Developer Portal エラーが発生します。 \ { ^ } % ` ] > [ ~ < # | & $ @ = 、 : + 、 ? 、スペース ' '

ユーザーが重複してダウンロードを排除するために、同じアイコン ファイルを参照している場合、アチーブメントはアイコンを共有できます。非表示のアチーブメントの「ロックされた」アイコンのように、複数のアチーブメントが同じ画像を使用する場合は、この機能を使用してください。