游戏服务是华为向开发者提供的能够快速开发游戏应用的服务。通过华为游戏服务，开发者可以使用用户的华为帐号登录游戏，从而迅速推广游戏，共享华为庞大的用户价值。
另外，为了激励玩家深入发掘游戏并提高其游戏水平，游戏可以提供成就功能。华为游戏服务能够帮助开发者快速展示成就、管理成就。
在本次Codelab中，您将建立一个能够具备简单游戏交互功能的Android应用程序，您的应用程序将包含：
集成HUAWEI HMS能力，需要完成以下准备工作
具体操作，请按照《HUAWEI HMS Core集成准备》中详细说明来完成。
针对Android Studio开发环境，华为提供了maven仓集成方式的HMS SDK包，开发游戏前需集成SDK到您的Android Studio项目中。
allprojects {
repositories {
google()
jcenter()
//配置如下地址
maven {url 'http://developer.huawei.com/repo/'}
}
}
buildscript {
repositories {
google()
jcenter()
//配置如下地址
maven {url 'http://developer.huawei.com/repo/'}
}
}
buildscript {
dependencies {
classpath 'com.android.tools.build:gradle:3.4.0'
//配置如下地址
classpath 'com.huawei.agconnect:agcp:1.2.0.300'
}
}
//配置如下地址
apply plugin: 'com.huawei.agconnect'
dependencies {
//配置如下地址
implementation 'com.huawei.hms:hwid:{version}'
implementation 'com.huawei.hms:iap:{version}'
implementation 'com.huawei.hms:game:{version}'
}
-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.hianalytics.android.**{*;}
-keep class com.huawei.updatesdk.**{*;}
-keep class com.huawei.hms.**{*;}
-keep class com.huawei.gamebox.plugin.gameservice.**{*;}
游戏应用与华为游戏服务交互的功能主要涉及游戏登录和游戏成就，本次Codelab中您可以在您的Android Studio工程中创建一个布局页面，参照下图进行UI设计。
步骤1 引入游戏相关类。
import com.huawei.hmf.tasks.OnFailureListener;
import com.huawei.hmf.tasks.OnSuccessListener;
import com.huawei.hmf.tasks.Task;
import com.huawei.hms.R;
import com.huawei.hms.api.HuaweiApiClient;
import com.huawei.hms.common.ApiException;
import com.huawei.hms.game.achievement.AchievementListActivity;
import com.huawei.hms.jos.AppUpdateClient;
import com.huawei.hms.jos.JosApps;
import com.huawei.hms.jos.JosAppsClient;
import com.huawei.hms.jos.games.AchievementsClient;
import com.huawei.hms.jos.games.Games;
import com.huawei.hms.jos.games.PlayersClient;
import com.huawei.hms.jos.games.player.Player;
import com.huawei.hms.jos.games.player.PlayerExtraInfo;
import com.huawei.hms.support.api.client.PendingResult;
import com.huawei.hms.support.api.client.ResultCallback;
import com.huawei.hms.support.api.client.Status;
import com.huawei.hms.support.api.entity.core.CommonCode;
import com.huawei.hms.support.api.game.CertificateIntentResult;
import com.huawei.hms.support.api.game.HuaweiGame;
import com.huawei.hms.support.api.game.PlayerCertificationInfo;
import com.huawei.hms.support.api.game.ShowFloatWindowResult;
import com.huawei.hms.support.hwid.HuaweiIdAuthManager;
import com.huawei.hms.support.hwid.result.AuthHuaweiId;
import com.huawei.hms.support.hwid.result.HuaweiIdAuthResult;
步骤2 在Application的onCreate方法中添加注册Activity的回调监听。
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
HuaweiMobileServicesUtil.setApplication(this);
}
@Override
public void onTerminate() {
super.onTerminate();
}
}
步骤3 启动时初始化游戏SDK。
@OnClick(R.id.btn_init)
public void init() {
JosAppsClient appsClient = JosApps.getJosAppsClient(this, null);
appsClient.init();
showLog("init success");
}
步骤4 显式登录。
@OnClick(R.id.btn_sign_in)
public void signIn() {
HuaweiIdAuthParams authParams = new HuaweiIdAuthParamsHelper(HuaweiIdAuthParams.DEFAULT_AUTH_REQUEST_PARAM_GAME).createParams();
Task<AuthHuaweiId> authHuaweiIdTask = HuaweiIdAuthManager.getService(this, authParams).silentSignIn();
authHuaweiIdTask.addOnSuccessListener(new OnSuccessListener<AuthHuaweiId>() {
@Override
public void onSuccess(AuthHuaweiId authHuaweiId) {
showLog("signIn success");
showLog("display:" + authHuaweiId.getDisplayName());
SignInCenter.get().updateAuthHuaweiId(authHuaweiId);
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
ApiException apiException = (ApiException) e;
showLog("signIn failed:" + apiException.getStatusCode());
showLog("start getSignInIntent");
signInNewWay();
}
}
});
}
public HuaweiIdAuthParams getHuaweiIdParams() {
return new HuaweiIdAuthParamsHelper(HuaweiIdAuthParams.DEFAULT_AUTH_REQUEST_PARAM_GAME).createParams();
}
public void signInNewWay() {
Intent intent = HuaweiIdAuthManager.getService(MainActivity.this, getHuaweiIdParams()).getSignInIntent();
startActivityForResult(intent, SIGN_IN_INTENT);
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (SIGN_IN_INTENT == requestCode) {
handleSignInResult(data);
} else {
showLog("unknown requestCode in onActivityResult");
}
}
private void handleSignInResult(Intent data) {
if (null == data) {
showLog("signIn inetnt is null");
return;
}
String jsonSignInResult = data.getStringExtra("HUAWEIID_SIGNIN_RESULT");
if (TextUtils.isEmpty(jsonSignInResult)) {
showLog("signIn result is empty");
return;
}
try {
HuaweiIdAuthResult signInResult = new HuaweiIdAuthResult().fromJson(jsonSignInResult);
if (0 == signInResult.getStatus().getStatusCode()) {
showLog("signIn success.");
showLog("signIn result: " + signInResult.toJson());
SignInCenter.get().updateAuthHuaweiId(signInResult.getHuaweiId());
} else {
showLog("signIn failed: " + signInResult.getStatus().getStatusCode());
}
} catch (JSONException var7) {
showLog("Failed to convert json from signInResult.");
}
}
步骤5 获取玩家信息。
@OnClick(R.id.btn_get_player)
public void getCurrentPlayer() {
PlayersClientImpl client = (PlayersClientImpl) Games.getPlayersClient(this, getAuthHuaweiId());
Task<Player> task = client.getCurrentPlayer();
task.addOnSuccessListener(new OnSuccessListener<Player>() {
@Override
public void onSuccess(Player player) {
currentPlayer = player;
String result = "display:" + player.getDisplayName() + "\n" + "playerId:" + player.getPlayerId() + "\n" + "playerLevel:"
+ player.getLevel() + "\n" + "timestamp:" + player.getSignTs()
+ "\n" + "playerSign:" + player.getPlayerSign();
showLog(result);
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog(result);
}
}
});
}
protected AuthHuaweiId getAuthHuaweiId() {
return SignInCenter.get().getAuthHuaweiId();
}
步骤1 拉起应用助手的成就列表页面。
@OnClick(R.id.btn_get_achieve_intent)
public void getAchievementIntent() {
AchievementsClient client = Games.getAchievementsClient(this, getAuthHuaweiId());
Task<Intent> task = client.getShowAchievementListIntent();
task.addOnSuccessListener(new OnSuccessListener<Intent>() {
@Override
public void onSuccess(Intent intent) {
if (intent == null) {
showLog("intent = null");
} else {
try {
startActivityForResult(intent, 1);
} catch (Exception e) {
showLog("Achievement Activity is Invalid");
}
}
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog(result);
}
}
});
}
步骤2 APP自行加载当前玩家所有成就数据。
跳转到自定义的成就展示页面AchievementListActivity。
@OnClick(R.id.btn_load_achievement)
public void loadAchievement() {
loadAchievement(true);
}
private void loadAchievement(boolean forceReload) {
if (getAuthHuaweiId() == null) {
showLog("signIn first");
return;
}
String jString = "";
try {
jString = getAuthHuaweiId().toJson();
} catch (JSONException e) {
showLog("signIn first");
}
Intent intent = new Intent(this, AchievementListActivity.class);
intent.putExtra("forceReload", forceReload);
intent.putExtra("mSign", jString);
startActivity(intent);
}
AchievementListActivity中加载成就数据示例代码如下：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_achievement_list);
mContext = this;
ButterKnife.bind(mContext);
initViews();
initData();
requestData();
}
private void initViews() {
LinearLayoutManager layoutManager = new LinearLayoutManager(mContext);
recyclerView.setLayoutManager(layoutManager);
adapter = new AchievementListAdapter(mContext, achievements, mContext);
recyclerView.setAdapter(adapter);
}
private void requestData() {
Task<List<Achievement>> task = client.getAchievementList(forceReload);
task.addOnSuccessListener(new OnSuccessListener<List<Achievement>>() {
@Override
public void onSuccess(List<Achievement> data) {
if (data == null) {
showLog("achievementBuffer is null");
return;
}
Iterator<Achievement> iterator = data.iterator();
achievements.clear();
while (iterator.hasNext()) {
Achievement achievement = iterator.next();
achievements.add(achievement);
}
adapter.setData(achievements);
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog(result);
}
}
});
}
private void initData() {
Intent intent = getIntent();
forceReload = intent.getBooleanExtra("forceReload", false);
String mSignString =intent.getStringExtra("mSign");
try {
authHuaweiId =AuthHuaweiId.fromJson(mSignString);
} catch (JSONException e) {
}
client = Games.getAchievementsClient(this, authHuaweiId);
}
点击成就后展示成就详情。
@Override
public void onItemClick(int postion) {
Intent intent = new Intent(this, AchievementDetailActivity.class);
Achievement achievement = achievements.get(postion);
intent.putExtra("achievementName",achievement.getDisplayName());
intent.putExtra("achievementDes",achievement.getDescInfo());
intent.putExtra("unlockedImageUri",achievement.getReachedThumbnailUri());
intent.putExtra("rvealedImageUri",achievement.getVisualizedThumbnailUri());
startActivity(intent);
}
步骤3 揭秘隐藏成就。
@Override
public void reveal(String achievementId, boolean isChecked) {
if (!isChecked){
client.visualize(achievementId);
}else {
performRevealImmediate(client,achievementId);
}
}
private void performRevealImmediate(AchievementsClient client, String achievementId) {
Task<Void> task = client.visualizeWithResult(achievementId);
task.addOnSuccessListener(new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void v) {
showLog("revealAchievemen isSucess");
requestData();
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog("achievement is not hidden"+result);
}
}
});
}
步骤4 增加成就当前已完成的步数。
@Override
public void increment(String achievementId, boolean isChecked) {
if (!isChecked){
client.grow(achievementId,1);
}else {
performIncrementImmediate(client,achievementId,1);
}
}
private void performIncrementImmediate(AchievementsClient client, String achievementId, int stepsNum) {
Task<Boolean> task = client.growWithResult(achievementId, stepsNum);
task.addOnSuccessListener(new OnSuccessListener<Boolean>() {
@Override
public void onSuccess(Boolean isSucess) {
if (isSucess) {
showLog("incrementAchievement isSucess");
requestData();
}else {
showLog("achievement can not grow");
}
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog("has bean already unlocked"+result);
}
}
});
}
步骤5 设置成就当前已完成的步数。
@Override
public void setStep(String achievementId, boolean isChecked) {
if (!isChecked){
client.makeSteps(achievementId,3);
}else {
performSetStepsImmediate(client,achievementId,3);
}
}
private void performSetStepsImmediate(AchievementsClient client, String achievementId, int stepsNum) {
Task<Boolean> task = client.makeStepsWithResult(achievementId, stepsNum);
task.addOnSuccessListener(new OnSuccessListener<Boolean>() {
@Override
public void onSuccess(Boolean isSucess) {
if (isSucess) {
showLog("setAchievementSteps isSucess");
} else {
showLog("achievement can not makeSteps");
}
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog("step num is invalid"+result);
}
}
});
}
步骤6 解锁成就。
@Override
public void Unlock(String achievementId, boolean isChecked) {
if (!isChecked){
client.reach(achievementId);
}else {
performUnlockImmediate(client,achievementId);
}
}
private void performUnlockImmediate(AchievementsClient client, String achievementId) {
Task<Void> task = client.reachWithResult(achievementId);
task.addOnSuccessListener(new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void v) {
showLog("UnlockAchievemen isSucess");
requestData();
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
if (e instanceof ApiException) {
String result = "rtnCode:" + ((ApiException) e).getStatusCode();
showLog("achievement has been already unlocked"+result);
}
}
});
}
在应用首页中依次点击"Init"、"SignIn"和"GetCurrentPlayer"，检查是否能够运行成功。
在首页点击"LoadAchievement"按钮，测试是否能够展示成就列表。
点击成就图标，测试是否能够展示成就详情。
点击"Unlock"、"IncrementSteps"、"SetSteps"，测试成就其他功能。
祝贺您，您已经成功地构建了您的第一个游戏应用程序，并学到了：
您可以在Github上下载源码：github.com/Huawei/Consumer/tree/master/Codelabs/GameService
也可以点击下方按钮下载源码。