เกมจะต้องระบุบัญชีของผู้เล่นที่ลงชื่อเข้าใช้เพื่อเข้าถึงฟังก์ชันการทำงานของบริการเกมของ Google Play เอกสารประกอบนี้จะอธิบายวิธีใช้ประสบการณ์การลงชื่อเข้าใช้ที่ราบรื่นในเกม
SDK บริการเกมของ Play เวอร์ชัน 2 มีการปรับปรุงมากมายที่จะเพิ่มจำนวนผู้ใช้ที่ลงชื่อเข้าใช้เกมของคุณ และทำให้การพัฒนาง่ายขึ้น
- การปรับปรุงสำหรับผู้ใช้
- หลังจากเลือกบัญชีเริ่มต้นแล้ว ผู้ใช้จะเข้าสู่ระบบโดยไม่ต้องโต้ตอบกับข้อความแจ้ง
- ผู้ใช้ไม่จำเป็นต้องดาวน์โหลดแอป Play Games เพื่อลงชื่อเข้าใช้ด้วยบริการเกมของ Play หรือสร้างบัญชีใหม่อีกต่อไป
- ตอนนี้ผู้ใช้จัดการบัญชีบริการเกมของ Play สำหรับเกมหลายเกมได้จากหน้าเดียว
- การปรับปรุงสําหรับนักพัฒนาแอป
- รหัสไคลเอ็นต์ไม่จำเป็นต้องจัดการขั้นตอนการลงชื่อเข้าใช้หรือออกจากระบบอีกต่อไป เนื่องจากการเข้าสู่ระบบจะทำงานโดยอัตโนมัติเมื่อเกมเริ่มต้น และมีการจัดการการจัดการบัญชีในการตั้งค่าระบบปฏิบัติการ
การผสานรวมลูกค้าใหม่ด้วยการลงชื่อเข้าใช้บริการเกมของ Play เวอร์ชัน 2
ส่วนนี้จะแสดงวิธีผสานรวมลูกค้าใหม่ด้วยการลงชื่อเข้าใช้บริการเกมของ Play เวอร์ชัน 2
เพิ่มการพึ่งพา SDK บริการเกมของ Play
เพิ่มทรัพยากร Dependency ของ SDK บริการเกมของ Play ลงในไฟล์รูทของแอป build.gradle
หากใช้ Gradle คุณจะเพิ่มหรืออัปเดต Depend ได้โดยทำดังนี้
dependencies {
implementation "com.google.android.gms:play-services-games-v2:+"
}
กำหนดรหัสโปรเจ็กต์บริการเกมของ Play
หากต้องการเพิ่มรหัสโปรเจ็กต์ SDK บริการเกมของ Play ลงในแอป ให้ทําตามขั้นตอนต่อไปนี้
ในไฟล์
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 ใน Callback 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()
}
);