本文將介紹華為游戲服務，並講解如何在MVVM架構的移動游戲App中使用游戲服務實現賬號登錄及認證功能。
-
什么是游戲服務？
游戲服務是華為為移動開發者提供的用於滿足各種移動游戲開發需求的服務。使用游戲服務，您可以輕松地在游戲中實現排行榜、事件、成就、存檔等功能。游戲服務有效簡化游戲的開發過程，讓您可以使用簡短有序的代碼結構創建游戲項目。
華為游戲服務，為您提供以下開發能力，幫助您更高效地開發游戲：
· 帳號登錄
· 游戲防沉迷
· 浮標
· 成就
· 事件
· 排行榜
· 游戲存檔
· 玩家數據統計
· 游戲基本信息獲取
-
軟件及硬件要求
· Android Studio 3.X 及以上版本
· JDK 1.8 及以上版本
· 您的應用應滿足以下條件：
— minSdkVersion: 17
— targetSdkVersion: 29
— compileSdkVersion: 29
-
開發流程
1. 集成
首先，您要先注冊成為華為開發者，並將HMS Core集成到項目中。 您可以從下面的鏈接訪問有關該步驟的材料。
https://medium.com/huawei-developers/android-integrating-your-apps-with-huawei-hms-core-1f1e2a090e98
2. 添加依賴
集成HMS Core到項目中並在AGC控制台開啟游戲服務之后，將所需依賴的庫添加到app目錄下的build.gradle文件中，如下所示：
dependencies {
implementation 'com.huawei.agconnect:agconnect-auth:1.5.1.300'
implementation 'com.huawei.hms:base: 5.0.5.300'
implementation 'com.huawei.hms:hwid: 5.2.0.300'
implementation 'com.huawei.hms:iap:5.0.1.300'
implementation 'com.huawei.hms:game: 5.0.4.302'
}
3. 創建Application類
當您的應用啟動時，游戲服務由Application類觸發啟動。游戲服務是在這個類中啟動的，而此類和項目一同啟動。創建BaseApplication類后，您需要在Manifest文件中定義它。
class BaseApplication : Application(){
companion object{
lateinit var instance: BaseApplication
private set
}
override fun onCreate() {
super.onCreate()
instance = this
HuaweiMobileServicesUtil.setApplication(this)
HwAds.init(this)
}
}
4. 設計登錄頁面
在所有權限和庫都添加到項目中后，您可以開始為您的游戲開發登錄頁面。此時就用到了華為認證服務。認證服務使您可以在控制台上查看游戲的所有用戶。此外，認證服務還提供了多種登錄方式：包含Facebook、Twitter、Google、郵箱、電話號碼或華為ID。我將分享一個通用的登錄頁面設計。以下是一個使用華為ID登錄的示例。
您可以在以下鏈接查看認證服務的文檔：
<androidx.constraintlayout.motion.widget.MotionLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
app:layoutDescription="@xml/motion_scene_splash"
android:id="@+id/id_09"
android:layout_height="match_parent">
<ImageView
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:src="@drawable/background"
android:alpha="0.7"
android:id="@+id/id_11"/>
<ImageView
android:id="@+id/imgView_logo"
android:layout_width="130dp"
android:layout_height="130dp"
android:layout_marginTop="80dp"
android:scaleType="centerInside"
android:src="@drawable/vs_logo"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<ImageView
android:id="@+id/imgView_logo_rays"
android:layout_width="130dp"
android:layout_height="130dp"
android:layout_marginTop="80dp"
android:scaleType="centerInside"
android:src="@drawable/vs_logo"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<ImageView
android:id="@+id/imgView_cloudLeft"
android:layout_width="130dp"
android:layout_height="130dp"
android:layout_marginTop="16dp"
android:scaleType="centerInside"
android:src="@drawable/cloud"
android:translationX="-20dp"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:tint="#9E9E9E" />
<ImageView
android:id="@+id/imgView_cloudRight"
android:layout_width="130dp"
android:layout_height="130dp"
android:layout_marginTop="120dp"
android:scaleType="centerInside"
android:src="@drawable/cloud"
android:translationX="20dp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:tint="#607D8B" />
<LinearLayout
android:id="@+id/linlay_inputs"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginStart="30dp"
android:alpha="1"
android:layout_marginLeft="30dp"
android:layout_marginEnd="30dp"
android:layout_marginRight="30dp"
android:gravity="center"
android:layout_marginTop="10dp"
android:orientation="vertical"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/imgView_cloudRight">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:fontFamily="@font/muli_regular"
android:text="Welcome Back"
android:textColor="#000000"
android:textSize="20sp"
android:id="@+id/id_12" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:fontFamily="@font/muli_regular"
android:text="Sign in to continue"
android:textColor="#000000"
android:textSize="14sp"
android:id="@+id/id_13" />
<EditText
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="30dp"
android:background="@drawable/et_background"
android:drawableStart="@drawable/ic_baseline_email_24"
android:drawableLeft="@drawable/ic_baseline_email_24"
android:drawablePadding="16dp"
android:hint="Email"
android:inputType="textEmailAddress"
android:padding="16dp"
android:textSize="14sp"
android:textColor="#000000"
android:fontFamily="@font/muli_regular"
android:id="@+id/id_14"/>
<EditText
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:background="@drawable/et_background"
android:drawableStart="@drawable/ic_baseline_lock_24"
android:drawableLeft="@drawable/ic_baseline_lock_24"
android:drawableEnd="@drawable/ic_baseline_visibility_24"
android:drawableRight="@drawable/ic_baseline_visibility_24"
android:drawablePadding="16dp"
android:hint="Password"
android:inputType="textPassword"
android:padding="16dp"
android:textSize="14sp"
android:textColor="#000000"
android:fontFamily="@font/muli_regular"
android:id="@+id/id_15"/>
<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="30dp"
android:background="@drawable/button_one"
android:text="@string/signInButton"
android:textAllCaps="false"
android:fontFamily="@font/muli_regular"
android:textColor="#7E675E"
android:id="@+id/id_16"/>
</LinearLayout>
<TextView
android:id="@+id/tv_forgotPassword"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:layout_marginEnd="30dp"
android:alpha="1"
android:layout_marginRight="30dp"
android:text="Forgot Password?"
android:textColor="#7E675E"
android:textSize="13sp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintTop_toBottomOf="@id/linlay_inputs" />
<ImageView
android:id="@+id/safads"
android:layout_width="wrap_content"
android:layout_height="100dp"
android:src="@drawable/color_logo"
app:tint="#9E9E9E"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/linlay_inputs"
android:visibility="invisible"/>
</androidx.constraintlayout.motion.widget.MotionLayout>
5. 創建LoginViewModel類
LoginViewModel類將從View類接收、處理數據並將處理過的數據發送到View類。所有的登錄操作都將在LoginViewModel類中完成。
首先，在HuaweiIdAuthService對象中創建客戶端。
private lateinit var mClient: HuaweiIdAuthService
接下來是開發帳戶注銷。這樣做的目的是結束應用中打開的會話。注銷后，我們需要創建login方法。首先，調用logout方法。然后添加startActivityForResult方法，並將其在View類重寫。
LoginViewModel類如下所示：
class LoginViewModel(private val context: Context): ViewModel(){
private lateinit var mClient: HuaweiIdAuthService
fun login(fragment: Fragment){
logout()
val huaweiIdAuthParamsHelper =HuaweiIdAuthParamsHelper(HuaweiIdAuthParams.DEFAULT_AUTH_REQUEST_PARAM)
val scopeList: MutableList<Scope> = ArrayList()
scopeList.add(Scope(HwIDConstant.SCOPE.ACCOUNT_BASEPROFILE))
huaweiIdAuthParamsHelper.setScopeList(scopeList)
val authParams = huaweiIdAuthParamsHelper.setAccessToken().createParams()
mClient = HuaweiIdAuthManager.getService(context, authParams)
fragment.startActivityForResult(mClient.signInIntent, 1002)
}
fun logout(){
Log.i(Constants.LOGIN_VIEWMODEL_TAG, "In LogOut Fun.")
val auth = AGConnectAuth.getInstance()
auth.signOut()
}
}
6. 創建LoginViewModelFactory類
創建LoginViewModelFactory類，並將上下文設置為參數。此類將返回ViewModel類。
class LoginViewModelFactory(private val context: Context): ViewModelProvider.NewInstanceFactory(){
override fun <T : ViewModel?> create(modelClass: Class<T>): T {
return LoginViewModel(context) as T
}
}
7. 創建LoginFragment
在XML文件上添加ViewModel依賴，並將它作為綁定對象。你需要再次打開XML文件，添加變量“viewmodel”，將type添加為ViewModel類目錄。
<data>
<variable
name="viewmodel"
type="com.xxx.xxx.viewmodel.LoginViewModel"/>
</data>
返回LoginFragment並添加工廠類、viewmodel類，並進行綁定。
private lateinit var binding: FragmentLoginBinding
private lateinit var viewModel: LoginViewModel
private lateinit var viewModelFactory: LoginViewModelFactory
在onCreateView方法上定義這些對象。
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
binding = DataBindingUtil.inflate(inflater, R.layout.activity_splash_login, container,false) as ActivitySplashLoginBinding
viewModelFactory =LoginViewModelFactory(requireContext() )
viewModel = ViewModelProviders.of(this, viewModelFactory).get(LoginViewModel::class.java)
return binding.root
}
創建登錄按鈕點擊事件監聽，並在ViewModel類中調用login方法。
var gameLoginButton = binding.id16.findViewById<View>(R.id.id_16)
gameLoginButton.setOnClickListener {
showProgressDialog()
viewModel.login(this)
}
最后，創建onActivityResult方法，查看登錄結果。如果登錄成功，您可以看到一些用戶信息，比如用戶名、ID、國家/地區、年齡等。認證服務提供了豐富的用戶信息，您可以在App中使用認證服務。
override fun onActivityResult(
requestCode: Int,
resultCode: Int,
@Nullable data: Intent?
) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == 1002) {
val signInHuaweiIdTask = HuaweiIdAuthManager.parseAuthResultFromIntent(data)
if (signInHuaweiIdTask.isSuccessful) {
val huaweiAccount = signInHuaweiIdTask.result
val accessToken = huaweiAccount.accessToken
Log.w(Constants.LOGIN_FRAGMENT_TAG, "accessToken: $accessToken")
val credential = HwIdAuthProvider.credentialWithToken(accessToken)
val provider_now = credential.provider
Log.w(Constants.LOGIN_FRAGMENT_TAG, "provider_now: $provider_now")
AGConnectAuth.getInstance().signIn(credential)
.addOnSuccessListener { signInResult ->
val user = AGConnectAuth.getInstance().currentUser
Log.w(Constants.LOGIN_FRAGMENT_TAG, "Login Success. User Display Name : " + user.displayName)
userName = user.displayName
//Start another fragment here.
(activity as MainActivity?)!!.setSelectedTab(Constants.TAB_LOGIN,Constants.TAB_HOME,false)
dismisProgressDialog()
}.addOnFailureListener { e: Exception ->
Toast.makeText(context, R.string.authenticationError, Toast.LENGTH_SHORT).show()
Log.w(Constants.LOGIN_FRAGMENT_TAG, "sign in for agc failed: " + e.message)
dismisProgressDialog()
}
} else {
Toast.makeText(context, R.string.sıgnInError, Toast.LENGTH_SHORT).show()
Log.e(Constants.LOGIN_FRAGMENT_TAG,"sign in failed : " + (signInHuaweiIdTask.exception as ApiException).statusCode)
dismisProgressDialog()
}
}
}
結論
現在您可以在游戲App上實現登錄功能啦。您也可以跟我一樣選擇使用認證服務，因為它可以為您提供多種用戶信息，您可以在AGC控制台中查看所有用戶。
在下一篇文章中，我將介紹“構建成就”（為游戲玩家自定義配置成就（最高200個），增加玩家的新鮮感和成就感，鼓勵玩家持續參與），並提供一個示例。請關注第二篇文章，以簡潔的結構開發您的游戲應用。
參考
欲了解HMS Core更多詳情，請參閱：
>>華為開發者聯盟官網
>>獲取開發指導文檔
>>參與開發者討論請到CSDN社區或者Reddit社區
>>下載demo和示例代碼請到Github或者Gitee
>>解決集成問題請到Stack Overflow
原文鏈接：https://developer.huawei.com/...
原作者：胡椒