2021年08月09日

[Unity - Android] Google Play Game Serviceのリーダーボードを実装したときのメモ

UnityでGoogle Play Game Serviceのリーダーボードを利用したときにハマったのでメモ。
Google Play Consoleの管理画面が新しくなって、ややこしくなった。



■略語の説明:
・GPGS = Google Play Game Service(リーダーボード等、ゲームで使う機能がある)
・GPC = Google Play Console(Androidアプリを管理するサイト)
・GCP = Google Cloud Platform(GPGSを使う時に使うOAuth認証を管理するサイト)



■注意点
@Unityでの実装編
・PlatformがAndroidになっている
GPGSのSDKを使っている
・GPGSとAdMobのSDKでAndroid Resolverが重複したとき、バージョンの新しい方を採用する
・2021年8月1日から、申請できるアプリはAndroid11.0(API30)以上
・GPGSのUnityでの設定は、
 Unity > Window > Google Play Gams > Setup > Android setup...
 「Resources Definition」の欄に入力するのは、
 Google Play Console > Playゲームサービス > 設定と管理 > リーダーボード > 画面右上の「リソースを取得」 > Android(XML) の内容 ※GPCでリーダーボードを既に作っていること
 Client IDは、Androidアプリなので空欄でOK。
・Android実機のログ確認は、
 Unity > Window > Analytics > Android Log Cat

AGoogle Play Console(管理画面)編
・.apkまたは.aabファイルを内部テストに登録している
・クローズドテストをする場合は、ストア情報を全て埋める必要がある
・ポリシー > ポリシーのステータス で、プライバシーポリシー(Webサイト)を登録する
・ポリシー > アプリのコンテンツ で、アンケートにすべて答える
・テスト > 内部テスト > テスター数 で、テストユーザーを登録する
 招待URLは、テスター数 の下にある「テストへの参加方法」にある。
・Playゲームサービス > 設定と管理 > テスター数 で、テストユーザーを登録する

BGoogle Cloud Platform(管理画面)編
・GPC > Playゲームサービス > 設定と管理 > 設定 > OAuthクライアント
 から GCP に行ける。
・GCPでは、必須項目以外は記入しない(色々と申請が面倒そう)
・認証情報 > SHA-1証明書のフィンガープリントに記入するのは、実機のログ(後述)で出力された方を採用。
 ※「keytool -keystore...」を使って取得したSHA-1証明書は、なぜかエラーになった
 ※GPC > 設定 > アプリの完全性 > SHA-1 証明書のフィンガープリント でもないので注意
・OAuth同意画面 > 公開ステータス が「本番環境 or テスト環境」かをチェックする
 ※テスト環境の場合、テストユーザーが登録されていることを確認する



■エラーの内容
実機で実行すると下記のエラーが出てGPGSの認証に失敗した。
下記の(1)(2)(3)を設定できているかチェックする。

APP NOT CORRECTLY CONFIGURED TO USE GOOGLE PLAY GAME SERVICES
DEVELOPER_ERROR
This is usually caused by one of these reasons:
(1) Your package name and certificate fingerprint do not match
the client ID you registered in Developer Console.

(2) Your App ID was incorrectly entered.

(3) Your game settings have not been published and you are
trying to log in with an account that is not listed as
a test account.

(4) A server auth code was requested, but an incorrect client
id was provided. The client id for server auth codes should
be the client id for the game server (not the android app).

To help you debug, here is the information about this app
Package name : [アプリのパッケージ名]
Cert SHA1 fingerprint: [XX:XX:XX:XX:.... といった、SHA-1証明書のフィンガープリント]
App ID from manifest : [GPC > Playゲームサービス > 設定と管理 > 設定 > プロジェクトID と一致]

※GCP > 認証情報 > OAuth2.0クライアントID > 該当ID > SHA-1証明書のフィンガープリント
 には、上記のフィンガープリントを設定する必要がある

【2021.8.10追記】
オープンテストのためGPCにアップロードしてストアからインストールしたところ、また認証で失敗して上記エラーが出た。PCから直接インストールするのと、ストアからインストールするのとで、フィンガープリントが違っていた。なぜ!
ということで、ログに出力されたフィンガープリントを改めてGCPで設定しなおすと、オープンテストでインストールしたアプリで認証できた。仕組みがわからない!




■リンク
GPGS(Google Play Game Service) for Unityプラグイン:
https://github.com/playgameservices/play-games-plugin-for-unity
※2021年8月9日時点 = v10.12

GPC(Google Play Console):
https://play.google.com/console/u/0/developers/

GCP(Google Cloud Platform):
https://console.cloud.google.com/apis/credentials



■参考
GPGSの実装でハマりやすい点:
https://qiita.com/flying_water_pot/items/eb18ad1e8520eb068907

UnityからAndroidの署名あり/なしビルド:
https://light11.hatenadiary.com/entry/2019/07/07/211057

GCPでOAuth同意画面の公開ステータスが「本番環境 or テスト環境」かチェック:
https://tyatran.hatenablog.com/entry/2020/12/29/140700

Xcodeの不要ファイルが重くなった場合の削除シェル:
https://qiita.com/star__hoshi/items/0ce9cd1c3793e6a951fc
posted by be-style at 10:31| Comment(0) | Unity