game 命令可列出賣方的 Partner Center 遊戲、依 Store ID、XBOX 遊戲識別碼或名稱查閱遊戲、建立遊戲,以及檢查其建立作業。
每個命令都會作用於一個賣方,該賣方來自 --seller-id 或您已儲存的賣方;請參閱內容。如果您屬於多個賣方,請參閱此已知問題:這些命令可能會使用另一個賣方。
命令
引數
選項
game get 至少需要 title-id、--store-id 或 --keyword 其中之一。位置值一律為 XBOX 遊戲識別碼;當它看起來像 Store ID 時,錯誤會建議使用搭配 --store-id 的相同命令:
列出和查閱
game list 會傳回賣方的整個目錄,而搭配 --keyword 的 game get 會搜尋整個目錄。讀取大型目錄可能需要幾分鐘,命令會在 stderr 上顯示其進度。沒有分頁選項;請使用 less 或 more 將輸出分頁。如果要求失敗,命令不會列印部分結果,並會將相互關聯識別碼寫入 stderr。每個要求會在兩分鐘後逾時;若要變更此值,請設定 XboxPartner:TimeoutSeconds (請參閱組態)。
輸出
JSON 輸出是一個games 陣列。每個遊戲都有下列欄位:
game create 和 game job get 會寫入建立作業。遊戲建立之後,就會出現具有相同欄位的 game 欄位。
表格輸出
list 和 get 接受 --output table,每個 XBOX 遊戲識別碼一列,並包含下列欄:TITLE ID、STORE IDS、PRODUCT NAME、MSA APP ID 和 PACKAGE FAMILY NAME。遊戲的 Store ID 和其他值會共用同一列,過長的值會被截斷。create 和 job get 會拒絕 --output table。
詳細資料檢視
--details 會為每個遊戲識別碼列印一個區塊,其中包含其下的每個遊戲及其所有識別碼 (包括 SCID 和開發沙箱),且不會截斷。遺漏的值會顯示為 -。使用 --details 或 --output table 時,結果計數和持續時間會傳送到 stderr。
建立遊戲
game create 在建立遊戲之前會先詢問;沒有終端機時,需要 --confirm。CLI 無法刪除遊戲。如果您屬於多個賣方,請先查看此已知問題:遊戲可能會建立在另一個賣方中。
命令只會傳送一次要求、最多等候建立作業兩分鐘,並將作業寫入 stdout。作業 ID、相互關聯識別碼以及用來檢查作業的命令會傳送到 stderr。如果等候先結束,作業會繼續執行:請使用 game job get 檢查它,不要再次建立遊戲。
如果要求失敗,stderr 會指出是否可能已建立遊戲:
- 當要求未傳送,或服務拒絕要求 (例如針對遊戲無法使用的沙箱傳回
400) 時,表示未建立任何遊戲。請修正問題,然後再次執行命令。 - 在發生伺服器錯誤、逾時或連線中斷之後,表示結果不明。在重試之前,請使用 stderr 上列印的命令檢查
game list。
檢查建立作業
job get 只會讀取,因此您可以隨意執行任意次數。已成功的作業仍可能會在其 errors 欄位中回報問題。
結束代碼
請勿根據結束代碼來決定是否再次執行
create。如果 stderr 指出未建立任何遊戲,請修正錯誤並再次執行;否則請使用它所列印的 game job get 或 game list 命令進行檢查。
端對端範例
儲存一次賣方,然後建立遊戲,該遊戲會使用此賣方:game create 在 stderr 上列印的作業 ID:
