เกมของคุณต้องให้บัญชีของผู้เล่นที่ลงชื่อเข้าใช้ จึงจะเข้าถึงฟังก์ชันการทำงานของบริการเกมของ Google Play ได้ เอกสารประกอบนี้อธิบายวิธีสร้างประสบการณ์การลงชื่อเข้าใช้ที่ราบรื่นในเกม
SDK บริการเกมของ Play เวอร์ชัน 2 มีการปรับปรุงมากมายที่เพิ่มจำนวนผู้ใช้ที่ลงชื่อเข้าใช้เกมของคุณและทำให้การพัฒนาง่ายขึ้น ดังนี้
- การปรับปรุงสำหรับผู้ใช้
- หลังจากเลือกบัญชีเริ่มต้นแล้ว ผู้ใช้จะเข้าสู่ระบบได้โดยไม่ต้องโต้ตอบกับข้อความแจ้ง
- ผู้ใช้ไม่จำเป็นต้องดาวน์โหลดแอป Play Games เพื่อลงชื่อเข้าใช้ด้วยบริการเกมของ Play หรือสร้างบัญชีใหม่อีกต่อไป
- ตอนนี้ผู้ใช้สามารถจัดการบัญชีบริการเกมของ Play สำหรับเกมหลายเกม ได้จากหน้าเดียว
- การปรับปรุงสำหรับนักพัฒนาซอฟต์แวร์
- รหัสไคลเอ็นต์ไม่จำเป็นต้องจัดการขั้นตอนการลงชื่อเข้าใช้หรือออกจากระบบอีกต่อไป เนื่องจากระบบจะทริกเกอร์การเข้าสู่ระบบโดยอัตโนมัติเมื่อเกมเริ่มต้น และคุณจะต้องจัดการบัญชีในการตั้งค่าระบบปฏิบัติการ
การผสานรวมลูกค้าใหม่กับการลงชื่อเข้าใช้บริการเกมของ Play v2
ส่วนนี้จะแสดงวิธีผสานรวมลูกค้าใหม่กับการลงชื่อเข้าใช้บริการเกมของ Play เวอร์ชัน 2
เพิ่มทรัพยากร Dependency ของ Play Games Services SDK
เพิ่มทรัพยากร Dependency ของ Play Games Services SDK ลงในไฟล์ build.gradle
ระดับรากของแอป หากใช้ Gradle คุณจะเพิ่มหรืออัปเดตความ Dependency ได้โดยทำดังนี้
dependencies {
implementation "com.google.android.gms:play-services-games-v2:+"
}
กำหนดรหัสโปรเจ็กต์บริการเกมของ Play
หากต้องการเพิ่มรหัสโปรเจ็กต์ Play Games Services SDK ลงในแอป ให้ทำตามขั้นตอนต่อไปนี้
ในไฟล์
AndroidManifest.xml
ของแอป ให้เพิ่มองค์ประกอบ<meta-data>
และแอตทริบิวต์ต่อไปนี้ลงในองค์ประกอบ<application>
<manifest> <application> <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/game_services_project_id"/> </application> </manifest>
กำหนดการอ้างอิงทรัพยากรสตริง
@string/game_services_project_id
โดยใช้รหัสโปรเจ็กต์บริการเกมของเกมเป็นค่า ดูรหัสโปรเจ็กต์ของบริการเกมได้ที่ใต้ชื่อเกมในหน้าการกำหนดค่าใน Google Play Consoleในไฟล์
res/values/strings.xml
ให้เพิ่มการอ้างอิงทรัพยากรสตริงและตั้งรหัสโปรเจ็กต์เป็นค่า ใน Google Play Console คุณจะดูรหัสโปรเจ็กต์ได้ที่ใต้ชื่อเกมในหน้าการกำหนดค่า เช่น<!-- res/values/strings.xml --> <resources> <!-- Replace 0000000000 with your game’s project id. Example value shown above. --> <string translatable="false" name="game_services_project_id"> 0000000000 </string> </resources>
เริ่มต้น SDK
เริ่มต้น Play Games SDK ในโค้ดเรียกกลับ onCreate(..)
ของคลาส Application
import com.google.android.gms.games.PlayGamesSdk;
...
@Override
public void onCreate(){
super.onCreate();
PlayGamesSdk.initialize(this);
}
รับผลการลงชื่อเข้าใช้
เมื่อเกมเปิดตัวแล้ว เกมจะพยายามลงชื่อเข้าใช้ให้ผู้ใช้เสมอ ในการตรวจสอบสิทธิ์ผู้ใช้ คุณต้องยืนยันว่าผู้ใช้ลงชื่อเข้าใช้เรียบร้อยแล้ว จากนั้นให้รับรหัสผู้เล่น
หากต้องการยืนยันความพยายามในการลงชื่อเข้าใช้ ให้โทรหา GamesSignInClient.isAuthenticated()
และใช้ addOnCompleteListener
เพื่อเรียกดูผลลัพธ์ เช่น
GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(getActivity());
gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
boolean isAuthenticated =
(isAuthenticatedTask.isSuccessful() &&
isAuthenticatedTask.getResult().isAuthenticated());
if (isAuthenticated) {
// Continue with Play Games Services
} else {
// Disable your integration with Play Games Services or show a
// login button to ask players to sign-in. Clicking it should
// call GamesSignInClient.signIn().
}
});
หากผู้ใช้เลือกที่จะไม่ลงชื่อเข้าใช้เมื่อเกมเปิดตัว คุณอาจเลือกที่จะแสดงปุ่มที่มีไอคอน Play Games ต่อไปและพยายามลงชื่อเข้าใช้ผู้ใช้อีกครั้งโดยโทรไปที่ GamesSignInClient.signIn()
หากผู้ใช้กดปุ่ม
หลังจากยืนยันว่าผู้ใช้ลงชื่อเข้าใช้แล้ว คุณจะเรียกข้อมูลรหัสผู้เล่นเพื่อระบุตัวผู้ใช้ได้ เช่น
PlayGames.getPlayersClient(activity).getCurrentPlayer().addOnCompleteListener(mTask -> {
// Get PlayerID with mTask.getResult().getPlayerId()
}
);