游戏基本信息是指游戏应用的相关信息,例如游戏的应用ID、游戏名称、游戏描述、游戏分类等。当开发者需要在游戏中使用游戏应用的信息时,可以从华为游戏服务器获取游戏基本信息。
用户必须打开华为应用市场(10.3及以上版本)中的游戏服务开关才能使用游戏基本信息功能。如果用户没有开启游戏服务开关,当游戏调用游戏基本信息相关接口时HMS SDK会自动拉起华为应用市场的游戏服务开关页面引导用户打开开关,如果用户未打开游戏服务开关,将返回7018错误码,游戏需要主动提示用户到华为应用市场“我的-设置-游戏服务”页面中开启游戏服务开关。

在使用游戏基本信息接口前都需要先调用Games.getGameSummaryClient方法获取GameSummaryClient实例。
- GameSummaryClient gamesummayClient = Games.getGameSummaryClient(activity, mAuthHuaweiId);
接口中传入的mAuthHuaweiId为用户登录游戏时获取的AuthHuaweiId对象,如果未登录可以传null。

如果已经获取过游戏基本信息,可以调用GameSummaryClient.getLocalGameSummary获取本地缓存的当前游戏信息。
- Task<GameSummary> task = client.getLocalGameSummary();
- task.addOnSuccessListener(new OnSuccessListener<GameSummary>() {
- @Override
- public void onSuccess(GameSummary gameSummary) {
- Log.i("GameSummary", "achievementCount:" + gameSummary.getAchievementCount());
- Log.i("GameSummary", "appId:" + gameSummary.getAppId());
- Log.i("GameSummary", "descInfo:" + gameSummary.getDescInfo());
- Log.i("GameSummary", "gameName:" + gameSummary.getGameName());
- Log.i("GameSummary", "gameHdImgUri:" + gameSummary.getGameHdImgUri().toString());
- Log.i("GameSummary", "gameIconUri:" + gameSummary.getGameIconUri().toString());
- Log.i("GameSummary", "rankingCount:" + gameSummary.getRankingCount());
- Log.i("GameSummary", "firstKind:" + gameSummary.getFirstKind());
- Log.i("GameSummary", "secondKind:" + gameSummary.getSecondKind());
- }
- }).addOnFailureListener(new OnFailureListener() {
- @Override
- public void onFailure(Exception e) {
- if (e instanceof ApiException) {
- String result = "rtnCode:" + ((ApiException) e).getStatusCode();
- Log.w("GameSummary", result);
- }
- }
- });
如果未获取过游戏基本信息,可以调用GameSummaryClient.getGameSummary 获取服务器保存的当前游戏信息。
- Task<GameSummary> task = client.getGameSummary();
- task.addOnSuccessListener(new OnSuccessListener<GameSummary>() {
- @Override
- public void onSuccess(GameSummary gameSummary) {
- Log.i("GameSummary", "achievementCount:" + gameSummary.getAchievementCount());
- Log.i("GameSummary", "appId:" + gameSummary.getAppId());
- Log.i("GameSummary", "descInfo:" + gameSummary.getDescInfo());
- Log.i("GameSummary", "gameName:" + gameSummary.getGameName());
- Log.i("GameSummary", "gameHdImgUri:" + gameSummary.getGameHdImgUri().toString());
- Log.i("GameSummary", "gameIconUri:" + gameSummary.getGameIconUri().toString());
- Log.i("GameSummary", "rankingCount:" + gameSummary.getRankingCount());
- Log.i("GameSummary", "firstKind:" + gameSummary.getFirstKind());
- Log.i("GameSummary", "secondKind:" + gameSummary.getSecondKind());
- }
- }).addOnFailureListener(new OnFailureListener() {
- @Override
- public void onFailure(Exception e) {
- if (e instanceof ApiException) {
- String result = "rtnCode:" + ((ApiException) e).getStatusCode();
- Log.w("GameSummary", result);
- }
- }
- });