ยินดีต้อนรับสู่การพัฒนาเกม Android ด้วยบริการเกมของ Google Play
Play Games SDK ให้บริการเกม Google Play แบบข้ามแพลตฟอร์มที่ช่วยให้คุณผสานรวมฟีเจอร์เกมยอดนิยม เช่น รางวัลพิเศษ ลีดเดอร์บอร์ด และเกมที่บันทึกไว้ในเกมแท็บเล็ตและเกมในอุปกรณ์เคลื่อนที่ได้อย่างง่ายดาย
การฝึกอบรมนี้จะแนะนำคุณให้ติดตั้งแอปพลิเคชันเกมตัวอย่างสำหรับ Android และเริ่มต้นสร้างเกม Android ของคุณเองได้อย่างรวดเร็ว แอปตัวอย่าง Type-a-Number Challenge นี้จะสาธิตวิธีผสานรวมรางวัลพิเศษและลีดเดอร์บอร์ดเข้ากับเกมของคุณ
ก่อนเริ่มต้น
ทําตามขั้นตอนในส่วนต่อไปนี้เพื่อเตรียมแอป
ข้อกำหนดเบื้องต้นของแอป
ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้
- สูงขึ้น
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.2.0'
}
คู่มือแอปตัวอย่าง
การฝึกอบรมนี้จะแนะนำวิธีติดตั้งแอปเกมตัวอย่างสำหรับ Android และเริ่มสร้างเกม Android ของคุณเองอย่างรวดเร็ว แอปตัวอย่าง Type-a-Number Challenge นี้จะสาธิตวิธีผสานรวมรางวัลพิเศษและลีดเดอร์บอร์ดเข้ากับเกมของคุณ
ขั้นตอนที่ 1: ดาวน์โหลดแอปตัวอย่าง
สำหรับคู่มือนักพัฒนาซอฟต์แวร์นี้ คุณจะต้องดาวน์โหลดแอปพลิเคชัน Android ตัวอย่างการท้าประเภท-a-Number
หากต้องการดาวน์โหลดและตั้งค่าแอปพลิเคชันตัวอย่างใน Android Studio ให้ทำดังนี้
- ดาวน์โหลดตัวอย่าง Android จากหน้าดาวน์โหลดตัวอย่าง
- นำเข้าโปรเจ็กต์
android-basic-samples
โปรเจ็กต์นี้มีTypeANumber
และตัวอย่างเกม Android อื่นๆ โดยทำดังนี้- คลิกไฟล์ > นำเข้าโปรเจ็กต์
- ไปที่ไดเรกทอรีที่คุณดาวน์โหลด
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 API ในแอปหรือไม่ ให้เลือกฉันยังไม่ได้ใช้ Google API ในเกมของฉันเลย
- สำหรับจุดประสงค์ของคู่มือนักพัฒนาซอฟต์แวร์นี้ คุณสามารถกรอกแบบฟอร์มด้วยรายละเอียดเกมของคุณเอง เพื่อความสะดวก คุณสามารถใช้ไอคอนตัวยึดตำแหน่งและภาพหน้าจอที่มีให้ในหน้าดาวน์โหลด
- ทำตามวิธีการเหล่านี้เพื่อสร้างรหัสไคลเอ็นต์ OAuth 2.0 สำหรับแอป Android
- เมื่อลิงก์แอป Android อย่าลืมระบุชื่อแพ็กเกจที่คุณใช้ก่อนหน้านี้เมื่อเปลี่ยนชื่อแพ็กเกจตัวอย่าง
- คุณใช้วิซาร์ด "สร้าง APK ที่ลงนามแล้ว" ใน Android Studio เพื่อสร้างคีย์สโตร์และใบรับรองที่ลงนามใหม่แล้วได้ หากยังไม่มี หากต้องการเรียนรู้วิธีเรียกใช้วิซาร์ดสร้าง APK ที่ลงนาม โปรดดูการลงนามแอปใน Android Studio
- โปรดบันทึกข้อมูลต่อไปนี้ไว้ใช้ภายหลัง
- รหัสแอปพลิเคชัน: เป็นสตริงที่ประกอบด้วยตัวเลข (โดยปกติจะเป็น 12 หลักขึ้นไป) ที่ตอนต้นของรหัสไคลเอ็นต์
- ใบรับรองที่ลงนาม: บันทึกใบรับรองที่คุณใช้เมื่อตั้งค่าการเข้าถึง API (ใบรับรองที่มีลายนิ้วมือ SHA1 ที่คุณระบุ) คุณควรใช้ใบรับรองเดียวกันเพื่อลงนามแอปเมื่อทดสอบหรือเผยแพร่แอป
- กำหนดค่ารางวัลพิเศษสำหรับการท้าทาย Type-a-Number ดังนี้
- เลือกแท็บรางวัลพิเศษใน Google Play Console
- เพิ่มตัวอย่างรางวัลพิเศษต่อไปนี้
ชื่อ คำอธิบาย คำขอพิเศษ สัญลักษณ์ไพร์ม ได้คะแนนเยอะที่สุด ไม่มี อ่อนน้อม ขอคะแนน 0 ไม่มี อย่าอวดดีนะ เด็กๆ ขอคะแนน 9,999 ในโหมดใดโหมดหนึ่ง ไม่มี สุดยอดไปเลย! รับคะแนน 1337 คะแนน ทำให้รายการนี้เป็นรางวัลพิเศษที่ซ่อนอยู่ เบื่อหน่าย เล่นเกม 10 ครั้ง ทำให้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ โดยมี 10 ขั้นตอนเพื่อปลดล็อก เบื่อจริงๆ เล่นเกม 100 ครั้ง ทำให้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ โดยมี 100 ขั้นตอนเพื่อปลดล็อก - บันทึกรหัส (สตริงที่เป็นตัวอักษรและตัวเลขคละกันยาว) ของรางวัลพิเศษแต่ละรายการที่คุณสร้างขึ้น
- กำหนดค่ารางวัลพิเศษที่เหมาะกับเกมของคุณ หากต้องการเรียนรู้เพิ่มเติม โปรดดูแนวคิดเบื้องหลังรางวัลพิเศษ และวิธีนำรางวัลพิเศษไปใช้ใน Android
- กำหนดค่าลีดเดอร์บอร์ดสำหรับการท้าทาย Type-a-Number ดังนี้
- เลือกแท็บลีดเดอร์บอร์ดใน 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
หากต้องการดูวิธีติดตั้งแอปพลิเคชัน โปรดดูการเรียกใช้ในอุปกรณ์