xbox upgrade で、新しいリリースが
利用可能かどうかを確認できます。修正済みとマークされた項目は最新リリースで修正されており、次のリリースで
削除されます。
問題が記載されていない場合
xbox upgradeで、最新リリースを実行していることを確認します。- 既存の Issue を検索します。
- 報告されていない場合は、
xbox feedbackで報告します。このコマンドは、 環境の詳細が入力されたバグ レポートを開きます。Issue は公開されるため、公開したくない情報は 含めないでください。
CLI の更新
xbox upgrade が HTTP 301 で失敗する
修正済み
CLI のパブリック リポジトリが移動したため、v0.2.1 の xbox upgrade は
毎回 HTTP 301: GitHub release metadata is unavailable で失敗します。
回避策: インストールの手順に従って、最新リリースをダウンロードします。
サインインと権限
一部のコマンドが個人用 Microsoft アカウントではまだ動作しない
職場または学校のアカウントではなく個人用 Microsoft アカウントでサインインすると、XBOX サービス構成、 テスト アカウント、パッケージ、プレイテスト、対象ユーザーのコマンドが動作しません。XBOX サービス構成と テスト アカウントのコマンドは HTTP 502 で失敗し、サービスが利用できないと報告されますが、再試行しても解決しません。 回避策: 職場または学校のアカウントでパートナー センターの販売者に参加し、そのアカウントで CLI に サインインします。xbox game、xbox xbl などのコマンドがまだサービス プリンシパルを受け入れない
サービス プリンシパルはサインインできますが、audience、game、package、playtest、sandbox、
seller、test-account、xbl コマンドをサービス プリンシパルとして実行すると、承認エラーで失敗します。
これらのコマンドが呼び出すサービスが、まだサービス プリンシパルを受け入れないためです。
回避策: これらのコマンドは、サインインしたユーザーとして実行します。xbox playfab コマンドは、
ユーザーが xbox playfab service-principal set で
アクセス権を付与すれば、サービス プリンシパルで動作します。
自動化 (サービス プリンシパル) の認証を参照してください。
複数の販売者に所属していると、一部の販売者でコマンドが拒否される
複数のパートナー センターの販売者に所属している場合、XBOX サービス構成、テスト アカウント、パッケージ、 プレイテスト、対象ユーザーのコマンドが、パートナー センターで最後に選択した販売者以外のすべての販売者で 拒否されることがあります。 回避策: パートナー センターで目的の販売者を選択してから、コマンドをもう一度実行します。xbox seller list で販売者の 1 つが表示されないことがある
複数のパートナー センターの販売者に所属している場合、xbox seller list で
エラーなしにそのうちの 1 つが表示されないことがあり、次回の実行では表示される場合があります。表示されない間は、
xbox audience list など、その販売者に対するコマンドが拒否されることがあり、
パートナー センターでその販売者を選択しても解決するかどうかはわかっていません。
xbox game コマンドが --seller-id を無視する
xbox game list、xbox game get、xbox game create は、--seller-id で渡した販売者や
コンテキストに保存した販売者ではなく、パートナー センターで最後に選択した販売者を
使用します。そのため、game create によって別の販売者にゲームが作成される可能性があります。入力ミスなど、
自分のものではない販売者 ID を指定しても失敗せず、自分のゲームが返されます。
回避策: パートナー センターで目的の販売者を選択し、ゲームを作成する前に、xbox game list に
その販売者のゲームが表示されることを確認します。変更が CLI に反映されるまでに最大 15 分かかる場合があります。
xbox sandbox コマンドでグローバル サンドボックスしか表示されない
--seller-id で渡した販売者やコンテキストに保存した販売者が、
パートナー センターで最後に選択した販売者でない場合、
xbox sandbox list と xbox sandbox get は失敗せずに、CERT、
CERT.DEBUG、RETAIL サンドボックスのみを検出します。xbox sandbox create は最後に選択した販売者に
サンドボックスを作成し、それが別の販売者である場合は、サンドボックスを読み戻せないため 4 で終了します。
再度作成しないでください。
回避策: パートナー センターで目的の販売者を選択してから、その販売者でコマンドをもう一度実行します。
変更が CLI に反映されるまでに最大 15 分かかる場合があります。
プレイテストと対象ユーザーを使用したテスト
xbox audience list がタイムアウトすることがある
xbox audience list は、リクエストがタイムアウトするほど時間がかかることがあります。
--name は、すべての対象ユーザーを読み取った後で一覧をフィルター処理するため、効果がありません。
XBOX サービス構成
ダウンロードした一部の XML ドキュメントで誤ったエンコードが宣言されている
xbox xbl config download --view published が保存する公開済みの XML ドキュメントの一部
(mpsdtitleinfo.xml や titlename-localization.xml など) は、encoding="utf-16" を宣言していますが、
実際には UTF-8 でエンコードされています。そのため、宣言を信頼する XML リーダーでは読み込みに失敗します。
回避策: 解析する前に、ファイルを UTF-8 としてデコードします。
PlayFab
xbox playfab api /Admin/UpdatePolicy で確認なしにポリシーが上書きされることがある
リクエスト本文に "OverwritePolicy": true を指定すると、この呼び出しは、xbox playfab api-policy set --overwrite の
安全対策なしに、タイトルの API アクセス ポリシー全体を置き換えます。--confirm は必要なく、
保存されたコンテキストまたは XBOX_PLAYFAB_TITLE_ID のタイトルを使用することもできます。
誤ったポリシーを設定すると、すべてのプレイヤーがタイトルから締め出される可能性があります。
回避策: 代わりに xbox playfab api-policy set --overwrite を
使用します。このコマンドでは、--confirm と、--playfab-title-id で渡したタイトルが必要です。
playfab title-data delete と playfab player-data delete が事前に確認を求めない
何かを削除するその他のコマンドは、実行前に確認を求めるか、--confirm がない場合は実行を拒否します。この
2 つのコマンドは、指定したキーを直ちに削除します。
--keys と --member-ids がコンマ区切りのリストを受け取る
xbox playfab title-data と xbox playfab player-data の --keys、および
xbox playfab group member の --member-ids は、コンマ区切りのリストを受け取ります。
これらは繰り返し指定するオプションに変更される予定であるため、これらを使用するスクリプトは更新が必要になります。
それまでは、--keys でコンマを含むキーを指定することはできません。そのようなキーを読み取るには、名前全体をそのまま受け取る
--key で渡しますが、delete には --keys しかありません。
回避策: キーを削除するには、delete が使用する API を
xbox playfab api で呼び出します。タイトル データの場合は、キーの値を null に設定します。
内部タイトル データの場合は、代わりに /Admin/SetTitleInternalData を使用します。
KeysToRemove にキーを指定します。
スクリプトとエージェント
ほとんどのコマンドは、変更が適用されたかどうか不明な場合に 1 で終了する
一部のコマンドは、リクエストの送信後にタイムアウトした場合など、変更が行われたかどうかを判断できない場合に3 で終了し、
そのことがページに記載されています。PlayFab のすべてのコマンドを含むその他のすべてのコマンドは、どの失敗でも 1 で終了するため、
スクリプトではこのケースと、変更が行われなかったケースを区別できません。
回避策: 何かを変更するコマンドが失敗した場合は、もう一度実行する前に現在の状態を確認します。