ยินดีต้อนรับสู่การพัฒนาเกม Android ด้วยบริการเกมของ Google Play
Play Games SDK ให้บริการเกม Google Play แบบข้ามแพลตฟอร์มที่ช่วยให้คุณผสานรวมฟีเจอร์เกมยอดนิยม เช่น รางวัลพิเศษ ลีดเดอร์บอร์ด และเกมที่บันทึกไว้ในแท็บเล็ตและเกมในอุปกรณ์เคลื่อนที่ได้ง่ายๆ
การฝึกอบรมนี้จะแนะนำให้คุณติดตั้งแอปพลิเคชันเกมตัวอย่างสำหรับ Android และเริ่มสร้างเกม Android ของคุณเองได้อย่างรวดเร็ว แอปตัวอย่างชาเลนจ์ Type-a-Number จะสาธิตวิธีการผสานรวมรางวัลพิเศษและลีดเดอร์บอร์ดลงในเกม
ก่อนเริ่มต้น
หากต้องการเตรียมแอป ให้ทำตามขั้นตอนในส่วนต่อไปนี้
ข้อกำหนดเบื้องต้นของแอป
ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้
- สูงขึ้น
minSdkVersion
จาก19
compileSdkVersion
ตั้งแต่28
ขึ้นไป
ตั้งค่าเกมใน Google Play Console
Google Play Console เป็นที่สำหรับจัดการบริการเกมของ Google Play สำหรับเกมของคุณ ตลอดจนกำหนดค่าข้อมูลเมตาสำหรับการให้สิทธิ์และตรวจสอบสิทธิ์ของเกม ดูข้อมูลเพิ่มเติมได้ที่การตั้งค่าบริการเกมของ Google Play
กำหนดค่าแอป
ในไฟล์ build.gradle
ระดับโปรเจ็กต์ ให้ใส่ที่เก็บ Maven ของ Google และที่เก็บส่วนกลาง Maven ไว้ในส่วน buildscript
และ allprojects
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
เพิ่มทรัพยากร Dependency ของบริการ Google Play สำหรับ Play Games SDK ลงในไฟล์บิลด์ Gradle ของโมดูล ซึ่งโดยทั่วไปคือ
app/build.gradle
dependencies {
implementation 'com.google.android.gms:play-services-games:23.1.0'
}
ตัวอย่างคู่มือแอป
การฝึกอบรมนี้จะแนะนำให้คุณติดตั้งแอปตัวอย่างเกมสำหรับ Android และเริ่มสร้างเกม Android ของคุณเองได้อย่างรวดเร็ว แอปตัวอย่างชาเลนจ์ Type-a-Number จะสาธิตวิธีการผสานรวมรางวัลพิเศษและลีดเดอร์บอร์ดลงในเกม
ขั้นตอนที่ 1: ดาวน์โหลดแอปตัวอย่าง
คุณจะต้องดาวน์โหลดตัวอย่างแอปพลิเคชัน Android สำหรับตัวอย่างชาเลนจ์ Type-a-Number สำหรับคู่มือนักพัฒนาซอฟต์แวร์นี้
วิธีดาวน์โหลดและตั้งค่าแอปพลิเคชันตัวอย่างใน Android Studio
- ดาวน์โหลดตัวอย่าง Android จากหน้าดาวน์โหลดตัวอย่าง
- นำเข้าโปรเจ็กต์
android-basic-samples
โปรเจ็กต์นี้มีTypeANumber
และตัวอย่างเกม Android อื่นๆ หากต้องการดำเนินการใน Android Studio ให้ทำดังนี้- คลิกไฟล์ > นำเข้าโปรเจ็กต์
- เรียกดูไดเรกทอรีที่คุณดาวน์โหลด
android-basic-samples
ลงในเครื่องการพัฒนา เลือกไฟล์android-basic-samples/build.gradle
แล้วคลิกตกลง
- ในโมดูล
TypeANumber
ให้เปิดAndroidManifest.xml
แล้วเปลี่ยนชื่อแพ็กเกจจากcom.google.example.games.tanc
เป็นชื่อแพ็กเกจอื่น ชื่อแพ็กเกจใหม่ต้องไม่ขึ้นต้นด้วยcom.google
,com.example
หรือcom.android
ขั้นตอนที่ 2: ตั้งค่าเกมใน Google Play Console
Google Play Console เป็นที่สำหรับจัดการบริการเกมของ Google Play สำหรับเกม รวมถึงกำหนดค่าข้อมูลเมตาสำหรับการให้สิทธิ์และตรวจสอบสิทธิ์ของเกม
วิธีตั้งค่าเกมตัวอย่างใน Google Play Console
- ชี้เว็บเบราว์เซอร์ไปที่ Google Play Console แล้วลงชื่อเข้าใช้ หากคุณยังไม่เคยลงทะเบียนสำหรับ Google Play Console มาก่อน คุณจะได้รับข้อความแจ้งให้ดำเนินการ
- ทำตามวิธีการเหล่านี้เพื่อเพิ่มเกมลงใน Google Play Console
- เมื่อระบบถามว่าคุณใช้ Google APIs ในแอปหรือไม่ ให้เลือกฉันยังไม่มี Google API ในเกมของฉัน
- สำหรับจุดประสงค์ของคู่มือนักพัฒนาซอฟต์แวร์นี้ คุณสามารถกรอกรายละเอียดเกมของคุณเองลงในแบบฟอร์มได้ เพื่อความสะดวก คุณสามารถใช้ไอคอนตัวยึดตำแหน่งและภาพหน้าจอที่มีอยู่ในหน้าดาวน์โหลด
- ทำตามวิธีการเหล่านี้เพื่อสร้างรหัสไคลเอ็นต์ OAuth 2.0 สำหรับแอป Android ของคุณ
- เมื่อลิงก์แอป Android อย่าลืมระบุชื่อแพ็กเกจที่ตรงกับที่คุณใช้ก่อนหน้านี้เมื่อเปลี่ยนชื่อแพ็กเกจตัวอย่าง
- คุณสามารถใช้วิซาร์ดการสร้าง APK ที่ลงนามใน Android Studio เพื่อสร้างคีย์สโตร์ใหม่และใบรับรองที่ลงนามได้ หากยังไม่มี ดูวิธีเรียกใช้วิซาร์ดสร้าง APK ที่ลงนามแล้วได้ที่การลงนามแอปใน Android Studio
- และอย่าลืมบันทึกข้อมูลต่อไปนี้ไว้ใช้ภายหลัง
- รหัสแอปพลิเคชัน: สตริงนี้ประกอบไปด้วยตัวเลขเท่านั้น (โดยทั่วไปคือ 12 หลักขึ้นไป) ที่ด้านหน้ารหัสไคลเอ็นต์
- ใบรับรองที่ลงนาม: สังเกตใบรับรองที่คุณใช้เมื่อตั้งค่าการเข้าถึง API (ใบรับรองที่คุณใช้ลายนิ้วมือ SHA1) คุณควรใช้ใบรับรองเดียวกันในการลงนามแอปเมื่อทดสอบหรือเผยแพร่แอป
- กำหนดค่ารางวัลพิเศษสำหรับชาเลนจ์ประเภทตัวเลข ดังนี้
- เลือกแท็บรางวัลพิเศษใน Google Play Console
- เพิ่มรางวัลพิเศษตัวอย่างต่อไปนี้
ชื่อ คำอธิบาย คำขอพิเศษ Prime ดูคะแนนซึ่งเป็นจำนวนเฉพาะ ไม่มี อ่อนน้อม ขอให้ให้คะแนน 0 คะแนน ไม่มี อย่าอวดนะเด็ก ขอคะแนน 9999 ทั้งสองโหมด ไม่มี สุดยอดไปเลย! ได้รับคะแนน 1337 คะแนน ทำให้เป็นรางวัลพิเศษที่ซ่อนอยู่ เบื่อ เล่นเกม 10 ครั้ง ทำให้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ ด้วย 10 ขั้นตอนในการปลดล็อก เบื่อหน่ายจริงๆ เล่นเกม 100 ครั้ง ทำให้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ ด้วย 100 ขั้นตอนเพื่อปลดล็อก - บันทึกรหัส (สตริงที่เป็นตัวอักษรและตัวเลขคละกันแบบยาว) สำหรับรางวัลพิเศษแต่ละรายการที่คุณสร้าง
- กำหนดค่ารางวัลพิเศษที่เหมาะกับเกมของคุณ ดูข้อมูลเพิ่มเติมได้ในแนวคิดเบื้องหลังรางวัลพิเศษและวิธีนำรางวัลพิเศษไปใช้ใน Android
- กำหนดค่าลีดเดอร์บอร์ดสำหรับชาเลนจ์ประเภทตัวเลข ดังนี้
- เลือกแท็บลีดเดอร์บอร์ดใน Google Play Console
- เพิ่มตัวอย่างลีดเดอร์บอร์ด 2 รายการ ได้แก่ ลีดเดอร์บอร์ดชื่อ "คะแนนสูงสุดอย่างง่าย" และอีกรายการชื่อ "คะแนนสูงสุดคุณภาพสูง" ลีดเดอร์บอร์ดทั้ง 2 รายการควรใช้การจัดรูปแบบคะแนนจำนวนเต็มที่มีทศนิยม 0 ตำแหน่ง และการจัดลำดับประเภทมากกว่าดีกว่า
- บันทึกรหัส (สตริงที่เป็นตัวอักษรและตัวเลขคละกันแบบยาว) สำหรับลีดเดอร์บอร์ดแต่ละรายการที่คุณสร้าง
- กำหนดค่าลีดเดอร์บอร์ดที่เหมาะกับเกมของคุณ หากต้องการข้อมูลเพิ่มเติม โปรดดูแนวคิดเบื้องหลังลีดเดอร์บอร์ดและวิธีใช้ลีดเดอร์บอร์ดใน Android
- เพิ่มบัญชีทดสอบสำหรับเกม ขั้นตอนนี้จำเป็นสำหรับแอปที่ยังไม่ได้เผยแพร่ใน Google Play Console เท่านั้น ก่อนเผยแพร่แอป จะมีเพียงบัญชีทดสอบ ที่แสดงใน Google Play Console เท่านั้นที่เข้าสู่ระบบได้ อย่างไรก็ตาม เมื่อเผยแพร่แอปพลิเคชันแล้ว ทุกคนจะสามารถเข้าสู่ระบบได้
ขั้นตอนที่ 3: แก้ไขโค้ด
หากต้องการเรียกใช้เกม คุณต้องกำหนดค่ารหัสแอปพลิเคชันเป็นทรัพยากรในโปรเจ็กต์ Android คุณจะต้องเพิ่มข้อมูลเมตาของเกมใน AndroidManifest.xml
ด้วย
- เปิด
res/values/ids.xml
แล้วแทนที่รหัสตัวยึดตำแหน่ง หากกำลังสร้างเกม Android ใหม่ตั้งแต่ต้น คุณจะต้องสร้างไฟล์นี้ก่อน- ระบุรหัสแอปพลิเคชันในทรัพยากร
app_id
- ระบุรหัสรางวัลพิเศษแต่ละรหัสที่คุณสร้างไว้ก่อนหน้านี้ในทรัพยากร
achievement_*
ที่เกี่ยวข้อง - ระบุรหัสลีดเดอร์บอร์ดแต่ละรายการที่คุณสร้างขึ้นก่อนหน้านี้ในทรัพยากร
leaderboard_*
ที่เกี่ยวข้อง
- ระบุรหัสแอปพลิเคชันในทรัพยากร
- เปิด
AndroidManifest.xml
แล้วป้อนชื่อแพ็กเกจในแอตทริบิวต์package
ขององค์ประกอบ <manifest
> หากคุณกำลังสร้างเกม Android จาก Scratch โปรดตรวจสอบว่าได้เพิ่มโค้ดต่อไปนี้ในองค์ประกอบ <application
> ด้วย<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
ขั้นตอนที่ 4: ทดสอบเกม
เพื่อให้แน่ใจว่าบริการเกมของ Google Play ทำงานได้อย่างถูกต้องในเกมของคุณ ให้ทดสอบแอปพลิเคชันก่อนที่จะเผยแพร่ใน Google Play
วิธีเปิดเกมบนอุปกรณ์ทดสอบอุปกรณ์จริง
- ตรวจสอบว่าคุณได้ตั้งค่าบัญชีทดสอบที่ใช้ลงชื่อเข้าสู่ระบบแอป (ตามที่อธิบายไว้ในขั้นตอนที่ 2)
- ส่งออก APK และลงนามด้วยใบรับรองเดียวกับที่คุณใช้ตั้งค่าโปรเจ็กต์ใน Google Play Console หากต้องการส่งออก APK ที่ลงนามแล้วใน Android Studio ให้คลิก สร้าง > สร้าง APK ที่ลงนามแล้ว
- ติดตั้ง APK ที่ลงนามแล้วในอุปกรณ์ทดสอบที่จับต้องได้โดยใช้เครื่องมือ
adb
หากต้องการเรียนรู้วิธีติดตั้งแอปพลิเคชัน โปรดดู การทำงานในอุปกรณ์