做了一款安卓小游戏，想让用户和全世界的玩家pk分数，如果自己建一个服务器收集分数再做排行太麻烦了，毕竟只是个小游戏，想找第三方sdk，之前发现SwarmConnect貌似有这个功能，但是这个官网和文档都太不友好，后来发现google play就有leaderboard排行榜功能，那就开始接入吧。
Play后台配置及获取参数
在google play console配置排行榜
- 配置游戏信息：应用描述、截图等基本信息，与普通应用配置一致，这里略去
-
配置排行榜：进入排行榜，点击创建排行榜，根据实际需求配置，比如按分数从高到低或是从低到高排序。创建成功之后会生成leaderboard_id用于上报分数及显示排行榜接口中使用。image.png
-
配置测试用户：进入Play游戏服务---测试用户数量中添加测试人员google账号gmail邮箱，这里需要注意，并非在“测试---开放式测试、封闭式测试、内部测试”中配置。只有配置了测试用户的账号才能参与测试。image.png
配置用户登录信息
-
创建凭证：用于使用google账号登录游戏使用image.png
-
新建OAuth 2.0 client客户端：
创建凭据
创建凭据
这是创建好的页面，在创建时一定要注意指纹为软件包签名文件的sha1码，可使用命令keytool -v -list -keystore xxx.jks获取结果中的sha1码。软件包名称一定要与软件的实际包名相符。填写凭据信息 关联client与google play 中的游戏：创建完成后点击刷新OAuth客户端即可从列表中选择与之关联。
代码调用
gradle引入相应sdk
用户使用leaderboard功能必须先要登录google账号，并且需要安装有google games（用户登录时，若没安装，sdk会引导玩家先安装），所以要同时集成leaderboard(集成在play-services-games)和登录的功能
implementation 'com.google.android.gms:play-services-games:21.0.0' //排行榜
implementation 'com.google.android.gms:play-services-auth:19.0.0' //登录
调用登录接口（必须先登录才能使用leaderboard）
//优先尝试静默登录，静默登录不会弹出登录确认框，对玩家体验更好
public void signInSilently() {
GoogleSignInOptions signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN;
final GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(mCtx);
if (GoogleSignIn.hasPermissions(account, signInOptions.getScopeArray())) {
// Already signed in.
// The signed in account is stored in the 'account' variable.
GoogleSignInAccount signedInAccount = account;
} else {
// Haven't been signed-in before. Try the silent sign-in first.
GoogleSignInClient signInClient = GoogleSignIn.getClient(mCtx, signInOptions);
signInClient
.silentSignIn()
.addOnCompleteListener(
new OnCompleteListener<GoogleSignInAccount>() {
@Override
public void onComplete(@NonNull Task<GoogleSignInAccount> task) {
if (task.isSuccessful()) {
// The signed in account is stored in the task's result.
GoogleSignInAccount signedInAccount = task.getResult();
} else {
// Player will need to sign-in explicitly using via UI.
// See [sign-in best practices](http://developers.google.com/games/services/checklist) for guidance on how and when to implement Interactive Sign-in,
// and [Performing Interactive Sign-in](http://developers.google.com/games/services/android/signin#performing_interactive_sign-in) for details on how to implement
// Interactive Sign-in.
// 若静默登录失败，采用带界面的显式登录
googleSignIn()
}
}
});
}
}
// 调用google显式登录
private void googleSignIn() {
GoogleSignInClient signInClient = GoogleSignIn.getClient(this,
GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN);
Intent intent = signInClient.getSignInIntent();
this.startActivityForResult(intent, RC_SIGN_IN);
}
上报分数到leaderboard
public void submitScore(int score) {
GoogleSignInAccount lastSignedInAccount = GoogleSignIn.getLastSignedInAccount(mCtx);
if (lastSignedInAccount == null) {
ToastUtil.showToast(mCtx, mCtx.getString(R.string.submit_score_signin_toast));
signInSilently();
return;
}
//leaderboard_id即为创建排行榜时生成的id
Games.getLeaderboardsClient(mCtx, lastSignedInAccount)
.submitScore(mCtx.getString(R.string.leaderboard_id), score);
}
展示排行榜
public void showLeaderboard(final Activity activity) {
GoogleSignInAccount lastSignedInAccount = GoogleSignIn.getLastSignedInAccount(mCtx);
if (lastSignedInAccount == null) {
ToastUtil.showToast(mCtx, mCtx.getString(R.string.submit_score_signin_toast));
signInSilently();
return;
}
//leaderboard_id即为创建排行榜时生成的id
Games.getLeaderboardsClient(mCtx, lastSignedInAccount)
.getLeaderboardIntent(mCtx.getString(R.string.leaderboard_id))
.addOnSuccessListener(new OnSuccessListener<Intent>() {
@Override
public void onSuccess(Intent intent) {
activity.startActivityForResult(intent, RC_LEADERBOARD_UI);
}
});
}
