本文將回答有關 SDK 和 Google Play 遊戲電腦版發布作業的常見問題。
營利
為什麼新增帳單或授權金鑰後,購買流程會失敗並顯示錯誤代碼 6?
在 Google Play 管理中心新產生的授權金鑰,會在商務後端經歷數小時的快取和傳播延遲,然後 Google Play 的內部快取才會在所有服務環境中同步。即使遊戲用戶端可以成功查詢產品詳細資料,在同步處理完成前,購買要求仍會失敗,並傳回錯誤代碼 6。上傳或更新授權金鑰後,請等待幾小時再測試購買交易。
我可以在沒有後端伺服器的情況下使用購買流程嗎?
從安全性角度來看,Google 建議使用後端伺服器。
詳情請參閱「在沒有後端伺服器的情況下處理」。
整合 Google Play 遊戲電腦版 SDK 後,是否能繼續使用現有的 API 付款系統?
所有付款都必須由 Google Play 遊戲電腦版 SDK 透過 Google Play 帳款服務處理。您無法在同一款遊戲中使用現有的 API 付款方式。
如何在開發人員模式下消耗購買項目?
在開發人員模式下,請在 3 分鐘內處理購買交易,否則系統會辦理退款。
是否支援週期性付款或訂閱?
近期內不會,但歡迎您提供具體用途,讓我們加入未來的藍圖。
購買呼叫中的帳單錯誤是什麼?
BillingError 是付款結果的回應。LaunchPurchaseFlow 會立即傳回,不會遭到封鎖,但您必須監聽回呼,才能知道何時完成並擷取結果。
如何使用用戶端購物驗證?
建議使用伺服器端購買交易和驗證程序。遊戲必須在許可清單中,才能處理用戶端應用程式的購買交易。如果您的遊戲需要存取權,請與 Google 合作夥伴聯絡。 詳情請參閱「在沒有後端伺服器的情況下處理」。
查詢產品詳細資料的 API 限制為何?
單次呼叫
QueryProductDetailsAPI 最多可查詢 50 項產品。如果超過這個上限,就必須將要求拆成多個呼叫。載入多個產品 SKU 時,為什麼產品查詢或購買流程會因內部錯誤而失敗?
如果一次查詢過多產品 SKU,或是在短時間內連續呼叫 C++ 中的
QueryProductDetails或 Unity 中的QueryProductDetailsAsync太多次 (例如在緊密迴圈中調度數十個批次呼叫,或為每個批次建立新的BillingClient執行個體),可能會導致本機 IPC 和後端連線超載。連線重設後,產品詳細資料查詢就會失敗,遊戲也無法取得啟動購買流程所需的優惠權杖。為避免在載入目錄時發生這些錯誤,請遵循下列做法:
- 遵循每次呼叫支援的產品數量:在單一
QueryProductDetails或QueryProductDetailsAsync呼叫中,查詢不超過 50 項產品,並將傳回的ProductDetails快取至記憶體,而非重複查詢完整目錄。如要進一步瞭解支援的批次限制和查詢產品詳細資料,請參閱上方的 API 限制問題、C++ 的「顯示可購買的產品」,以及 Unity 的「查詢產品詳細資料」。 - 避免在短時間內連續呼叫 API 太多次:請勿同時或連續分派多個產品查詢批次,而不調整速度。重複使用單一
BillingClient執行個體、序列化要求,或將並行限制為一次最多兩或三個執行中的呼叫,並在連續批次之間加入短暫延遲。 - 更新至最新版 SDK:請前往 Play 遊戲電腦版 SDK 下載頁面,將整合功能更新至最新版 Google Play Games 電腦版 SDK (C++ 26.9.261.0 版或 Unity 26.9.261.0 版),確保用戶端包含最新的帳單和處理序間通訊 (IPC) 穩定性改善項目。
- 遵循每次呼叫支援的產品數量:在單一
在帳款用戶端中呼叫 Query Purchases 或 Launch Purchase Flow 時,需要哪些參數?
這個函式接受
QueryPurchasesContinuation,也就是具有std::function<void(QueryPurchasesResult)>簽章的函式回呼。回呼會將結果與所有ProductPurchaseDetails一併傳遞給您。這項資訊位於includes/billing/models.h檔案的 SDK 標頭檔案中。產生的
launch_purchase_flow_result具有ok()和code()函式。ok()函式會傳回流程是否成功。code()函式會傳回BillingError列舉 (includes/billing/enums.h),其中包含 10 種可能的錯誤情況,例如使用者取消或網路錯誤。Billing Client 的啟動購買流程是否支援自訂排序?
在目前的 SDK 設計中,無法傳入自己的酬載。不過,您可以提供
obfuscated_account_id和obfuscated_profile_id的任意組合。你可以不提供、只提供其中一項,或兩者都提供。offer_token欄位為必填,用於指定使用者在結帳程序中嘗試購買的商品。目前,Google Play 中的每個 SKU 都只有一個優惠 (例如,以 $10 美元購買一項商品)。日後,Play 帳款服務團隊將提供多項優惠。為確保在購買流程中斷時中繼資料仍與購買交易相關聯,請在啟動購買對話方塊之前,將中繼資料儲存在後端伺服器,並將其與使用者的帳戶 ID、購買時的 SKU 以及目前的時間戳記建立關聯。詳情請參閱「將購買交易與內部資料建立關聯」。
從採用 OAuth 的 Google 帳款服務,改用以 DLL 為基礎的 Google 帳款服務,需要符合哪些條件?
遊戲可以繼續使用 OAuth 登入 Google,管理登入的帳戶,但 Google 建議您停止使用舊版 REST Billing API。從 REST 帳款 API (使用 OAuth2 登入) 切換至 SDK 流程,可以透過功能旗標操作,因此在遊戲切換期間,兩者可以並存一段時間。
Launch Purchase Flow API 呼叫是否透過網路瀏覽器處理?
不會,現在購買流程完全在遊戲內完成,使用流暢的 WebView 疊加層,不必離開遊戲用戶端。
使用者是否需要分別登入每款遊戲才能購買?
Google Play Games 會使用前景帳戶進行每場遊戲工作階段,因此您不必再次登入。遊戲工作階段開始時,您在 Google Play 遊戲中使用的帳戶就是發出 API 呼叫的帳戶。購買流程會自動使用這個帳戶。
遊戲可以同時支援電腦 SDK 和舊版付款系統嗎?
付款系統會根據遊戲二進位檔版本,採用雙流程模式運作。使用舊版建構的使用者會繼續使用現有流程,而使用新版建構的使用者則會轉換為以 SDK 為基礎的付款方式。在轉換期間,兩種付款流程的使用者會並存。
Windows App Bundle
使用第三方啟動器提交 WAB 時,是否需要提供遊戲套件供審查?
您只需提交安裝程式,不必提交整個遊戲套件,審查人員可使用安裝程式下載遊戲套件。
WAB 檔案大小是否有限制?
如果是安裝程式發布,WAB 檔案大小上限為 10 GB。如果是 Play 控管型發布,WAB 檔案大小上限為 200 GB。
為什麼上傳 WAB 後,遊戲沒有安裝或顯示?
如果遊戲在加入計畫時沒有預先存在的電腦版 (「首次 WAB」),系統可能會自動將遊戲置於控管型發布保留狀態。這是因為沒有可更新的基準。如要完整發布 WAB 並開放安裝遊戲,請前往 Google Play 管理中心,手動執行必要的發布動作 (例如點選「發布變更」)。
如何上傳 WAB 進行內部測試?
將許可清單帳戶提供給 Google,以便 Google 啟用這些帳戶進行內部測試。Google 取得清單後,會確保這些人員加入新手上路程序。
應將 WAB 套件上傳到何處?
您可以在第一個問題中提及的位置上傳 WAB 套件。但無法手動發布。您必須向 Google 後端人員提供精確的世界標準時間 (精確到小時)。Google 接著會設定發布時間表,並確保準時發布。
電腦版 SDK
舊版 API 和 Google Play 遊戲電腦版 SDK 有何差異?
- 舊版 API 僅提供帳單功能。
- 電腦版 SDK 支援 Google 桌面服務 (GDS) 和完整的電腦功能。
- PC SDK 不需要透過瀏覽器登入 Google。
是否有其他方法可以初始化 SDK,例如直接使用遊戲啟動器啟動遊戲,而不透過 Google Play 遊戲電腦版?
遊戲必須透過 Google Play 遊戲電腦版用戶端啟動。詳情請參閱這份開發人員文件。
PC SDK 是否支援 PEM 憑證檔案中的多位元組字元?
是,SDK 支援多位元組字元認證。
SDK 如何處理多個執行個體或帳戶的 Google 帳戶登入作業?
在 Google Play 遊戲中,每次啟動遊戲都會視為「遊戲工作階段」,每個「遊戲工作階段」都可以與一個帳戶建立關聯。兩者可能不同。因此,如果您使用帳戶 A 啟動遊戲,然後切換至帳戶 B 並重新啟動,兩者可以同時執行。
Play Install Referrer 整合功能是否能與 PC SDK 搭配運作?
PC SDK (25.5.409.0 以上版本) 支援 Play Install Referrer API。詳情請參閱「Play Install Referrer API」。
啟動器
如果玩家使用第三方啟動器,而非 Google Play 用戶端,他們的 Play 遊戲服務帳戶會自動同步嗎?
遊戲必須直接透過 Google Play 遊戲用戶端啟動,SDK 函式才能運作。如果遊戲是由其他程序 (例如安裝程式或啟動器應用程式) 啟動,則該程序本身必須從 Google Play Games 用戶端啟動。遊戲必須將從用戶端收到的所有參數傳遞至用戶端程序。
如果 Google Play 遊戲啟動第三方遊戲啟動器,該如何處理初始化作業?
您不必將 SDK 直接整合至啟動器。 不過,您必須將啟動器從 Google Play Games 用戶端收到的所有指令列引數,直接傳遞至產生的子項程序 (遊戲執行檔)。如果初始化失敗 (例如傳回
kActionRequiredShutdownClientProcess),則必須終止所有程序 (包括啟動器),以便 Google Play Games 嘗試自動復原並重新啟動遊戲。詳情請參閱設定指南的步驟 5。遊戲和啟動器正式上線後,如何處理更新和維護作業?
後續的更新和維護作業必須透過啟動器執行。Google Play Games 用戶端不支援更新功能,因此啟動器必須能夠更新遊戲和啟動器本身。
安裝程式如何接收自動播放的 GPG 工作階段符記?
GPG 會使用
--g_session_token=<token>指令列引數,將工作階段符記傳遞至安裝程式。如要啟用這項功能,您必須在play_publishing_config.xml中設定acceptsCommandLineArguments="true"。安裝程式會負責擷取這個權杖,並用來啟動遊戲。如果權杖產生失敗,GPG 會在沒有權杖的情況下啟動安裝程式 (備用)。
初始化
使用 Google Play 遊戲應用程式啟動遊戲時,系統會同步我的 Google 帳戶詳細資料嗎?
透過 Google Play Games 用戶端啟動遊戲後,帳戶會自動同步,不需要再次透過 Google 登入程序登入。
可以重複使用初始化參數嗎?
只要 Google Play Games 用戶端正在執行,且登入資訊有效,就能執行這項操作。不過,在指南所述的情境中,當使用者關閉遊戲,或遊戲因 SDK 初始化失敗 (例如
kActionRequiredShutdownClientProcess) 而結束時,遊戲啟動的所有程序都必須終止。有沒有辦法建立捷徑,直接開啟遊戲?
您可以使用下列 URI 直接開啟遊戲:
googleplaygames://launch/?pid=2&id=com.company.gamenameURI 支援偵測 Google Play 遊戲電腦版用戶端是否已開啟。如果用戶端未開啟,Google Play Games 用戶端會在遊戲或啟動器執行前開啟。您需要管理遊戲或啟動器,避免執行多個執行個體。
是否可以不使用 SDK,驗證 Google Play 遊戲電腦版安裝作業?
如要確認 Google Play 遊戲電腦版的安裝狀態,不需整合 SDK,只要檢查是否有下列 Windows 登錄機碼即可:
HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services如果這個機碼存在,表示電腦已安裝 Google Play 遊戲服務 (在電腦上執行遊戲的必要服務)。如果缺少金鑰,請引導使用者前往 Google Play 遊戲電腦版安裝頁面,下載並安裝用戶端。
測試
是否有類似行動裝置的公開測試或封閉測試環境?
雖然我們不提供專屬的端對端沙箱,但我們瞭解開發人員需要類似正式環境的測試環境。我們很快就會提供更完善的解決方案。
如何新增測試人員?
Google 聯絡窗口會為每個 PC 專案建立電子郵件群組,您必須將測試人員的 Google 帳戶加入群組。只有這個電子郵件群組的成員,才有權在 Google Play Games 中下載測試套件。
其他
我可以使用 VPN 嗎?
如果開發人員需要在不支援 Google Play 遊戲電腦版的地區測試遊戲,建議使用 VPN 從支援的地區取得 IP 位址。
請務必在 VPN 上啟用 TUN 模式。如需啟用 TUN 模式和設定防火牆的指引,請參閱 VPN 供應商的操作手冊。
如何開始在 Unity 或 UE 編輯器中開發 Google Play 遊戲電腦版?
- 啟用開發人員模式,然後繼續測試。
- 新增
manifest.xml和.dll檔案。詳情請參閱開發人員說明文件。 - 註冊搶先體驗合作夥伴 GUID,以便進行測試。
如何正確使用登錄機碼?
請根據根登錄區建立登錄機碼。您可以根據目的和資料性質,將根巢設為
HKEY_LOCAL_MACHINE或HKEY_CURRENT_USER。指南中以HKEY_LOCAL_MACHINE蜂巢為例。Google 審查電腦套件時有哪些規定?
電腦套件會經過惡意軟體掃描,之後審查人員只會測試遊戲安裝、成功啟動和解除安裝程序。
是否需要整合所有 API?
其他 API 則非必要,但可提供額外好處。如要提供應用程式內購和銷售數位內容,必須使用
google::play::billing。google::play::install_referrer是追蹤參照連結網址資料的必要項目,可協助您瞭解哪些流量來源帶來最多應用程式下載量。google::play::games::integrity是保護應用程式免受惡意人士攻擊的必要項目,可偵測潛在風險裝置和不明模擬器。為什麼關閉 Google Play Games 用戶端時,有些遊戲程序會終止,有些則不會?
Google 不會控管執行中遊戲的子程序或程序。行為取決於遊戲是模擬 Android 遊戲還是電腦遊戲。模擬遊戲會安裝在專屬環境中,因此行為主要取決於模擬器的初始化和關閉。
我應該使用 Google Play Games 解除安裝功能,還是自訂解除安裝程式?
Google 建議使用 Google Play Games 解除安裝功能。
其他協助
如果需要進一步協助,但本常見問題集未涵蓋相關內容,請來信至 google-play-games-pc@google.com