เริ่มต้นใช้งานบริการเกมของ Play สำหรับ Android

ยินดีต้อนรับสู่การพัฒนาเกม Android ด้วยบริการ Google Play Games

Play Games SDK มีบริการ Google Play Games แบบข้ามแพลตฟอร์มที่ช่วยให้คุณผสานรวมฟีเจอร์การเล่นเกมยอดนิยม เช่น รางวัลพิเศษ ลีดเดอร์บอร์ด และเกมที่บันทึกไว้ ลงในเกมบนแท็บเล็ตและอุปกรณ์เคลื่อนที่ได้อย่างง่ายดาย

การฝึกอบรมนี้จะแนะนำวิธีติดตั้งแอปพลิเคชันเกมตัวอย่างสำหรับ 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 ตัวอย่างภารกิจสุดท้าทายให้พิมพ์ตัวเลข

วิธีดาวน์โหลดและตั้งค่าแอปพลิเคชันตัวอย่างใน Android Studio

1. ดาวน์โหลดตัวอย่าง Android จากหน้าดาวน์โหลดตัวอย่าง
2. นำเข้าโปรเจ็กต์ android-basic-samples โปรเจ็กต์นี้มีตัวอย่างเกม TypeANumber และเกม Android อื่นๆ โดยทำดังนี้
   1. คลิก File > Import Project
   2. เรียกดูไดเรกทอรีที่คุณดาวน์โหลด android-basic-samples ในเครื่องสำหรับพัฒนา เลือกไฟล์ android-basic-samples/build.gradle แล้วคลิกตกลง
3. ในโมดูล TypeANumber ให้เปิด AndroidManifest.xml แล้วเปลี่ยนชื่อแพ็กเกจจาก com.google.example.games.tanc เป็นชื่อแพ็กเกจอื่นของคุณ ชื่อแพ็กเกจใหม่ต้องไม่ขึ้นต้นด้วย com.google, com.example หรือ com.android

ขั้นตอนที่ 2: ตั้งค่าเกมใน Google Play Console

Google Play Console เป็นแพลตฟอร์มที่คุณจัดการบริการ Google Play Games สำหรับเกม รวมถึงกำหนดค่าข้อมูลเมตาสำหรับการให้สิทธิ์และตรวจสอบสิทธิ์เกม

วิธีตั้งค่าเกมตัวอย่างใน Google Play Console

1. ชี้เว็บเบราว์เซอร์ไปที่ Google Play Console แล้วลงชื่อเข้าใช้ หากยังไม่เคยลงทะเบียนใช้ Google Play Console มาก่อน ระบบจะแจ้งให้ดำเนินการ
2. ทำตามวิธีการเหล่านี้เพื่อเพิ่มเกมลงใน Google Play Console
   1. เมื่อระบบถามว่าคุณใช้ Google APIs ในแอปหรือไม่ ให้เลือกฉันยังไม่ได้ใช้ Google APIs ในเกม
   2. สำหรับจุดประสงค์ของคู่มือนักพัฒนาซอฟต์แวร์นี้ คุณสามารถกรอกแบบฟอร์มด้วยรายละเอียดเกมของคุณเอง คุณสามารถใช้ไอคอนตัวยึดตำแหน่งและภาพหน้าจอที่ระบุไว้ในหน้าการดาวน์โหลดเพื่อความสะดวก
3. ทำตามวิธีการเหล่านี้เพื่อสร้างรหัสไคลเอ็นต์ OAuth 2.0 สำหรับแอป Android
   1. เมื่อลิงก์แอป Android อย่าลืมระบุชื่อแพ็กเกจที่คุณใช้ก่อนหน้านี้เมื่อเปลี่ยนชื่อแพ็กเกจตัวอย่าง
   2. คุณสามารถใช้วิซาร์ดสร้าง APK ที่ลงชื่อใน Android Studio เพื่อสร้างคีย์สโตร์ใหม่และใบรับรองที่ลงชื่อหากยังไม่มี ดูวิธีเรียกใช้วิซาร์ดสร้าง APK ที่ลงนามได้ที่การรับรองแอปใน Android Studio
4. โปรดบันทึกข้อมูลต่อไปนี้ไว้ใช้ภายหลัง
   1. รหัสแอปพลิเคชันของคุณ: สตริงที่ประกอบด้วยตัวเลขเท่านั้น (โดยปกติ 12 หลักขึ้นไป) ที่ขึ้นต้นด้วยรหัสไคลเอ็นต์
   2. ใบรับรองการรับรอง: จดบันทึกใบรับรองที่คุณใช้เมื่อตั้งค่าการเข้าถึง API (ใบรับรองที่มีลายนิ้วมือ SHA1 ที่คุณระบุ) คุณควรใช้ใบรับรองเดียวกันเพื่อลงนามแอปเมื่อทดสอบหรือเผยแพร่แอป
5. กำหนดค่ารางวัลสำหรับภารกิจพิมพ์ตัวเลข
   1. เลือกแท็บรางวัลใน Google Play Console
   2. เพิ่มตัวอย่างรางวัลพิเศษต่อไปนี้

      ชื่อ	คำอธิบาย	คำขอพิเศษ
      สัญลักษณ์ไพร์ม	รับคะแนนที่เป็นจำนวนเฉพาะ	ไม่มี
      อ่อนน้อม	ขอคะแนน 0	ไม่มี
      อย่าหลงตัวเองนะ	ขอคะแนน 9999 ในโหมดใดโหมดหนึ่ง	ไม่มี
      OMG U R TEH UBER LEET!	ได้รับคะแนน 1337	ทำให้รางวัลพิเศษนี้เป็นรางวัลพิเศษที่ซ่อนอยู่
      เบื่อ	เล่นเกม 10 ครั้ง	ทำให้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ โดยมี 10 ขั้นตอนเพื่อปลดล็อก
      เบื่อจริงๆ	เล่นเกม 100 ครั้ง	ทำให้รางวัลพิเศษเป็นแบบเพิ่มขึ้นเรื่อยๆ โดยมี 100 ขั้นตอนให้ปลดล็อก

   3. บันทึกรหัส (สตริงที่เป็นตัวอักษรและตัวเลขคละกันยาว) ของรางวัลพิเศษแต่ละรายการที่คุณสร้างขึ้น
   4. กำหนดค่ารางวัลพิเศษที่เหมาะกับเกมของคุณ ดูข้อมูลเพิ่มเติมได้ที่แนวคิดเบื้องหลังรางวัลพิเศษและวิธีใช้รางวัลพิเศษใน Android
6. กำหนดค่าลีดเดอร์บอร์ดสำหรับภารกิจพิมพ์ตัวเลข ดังนี้
   1. เลือกแท็บลีดเดอร์บอร์ดใน Google Play Console
   2. เพิ่มลีดเดอร์บอร์ดตัวอย่าง 2 รายการ โดยรายการหนึ่งชื่อ "คะแนนสูงอย่างง่าย" และอีกรายการหนึ่งชื่อ "คะแนนสูง" ลีดเดอร์บอร์ดทั้ง 2 รายการควรใช้การจัดรูปแบบคะแนนจำนวนเต็มโดยมีทศนิยม 0 ตำแหน่ง และเรียงลำดับประเภทใหญ่กว่าดีกว่า
   3. บันทึกรหัส (สตริงตัวอักษรและตัวเลขคละกันแบบยาว) ของตารางอันดับแต่ละรายการที่คุณสร้างขึ้น
   4. กำหนดค่าลีดเดอร์บอร์ดที่เหมาะสมกับเกม หากต้องการเรียนรู้เพิ่มเติม โปรดดูแนวคิดเบื้องหลังลีดเดอร์บอร์ดและวิธีใช้งานลีดเดอร์บอร์ดใน Android
7. เพิ่มบัญชีทดสอบสำหรับเกมของคุณ ขั้นตอนนี้จำเป็นสำหรับแอปที่ยังไม่ได้เผยแพร่ใน Google Play Console เท่านั้น ก่อนที่จะเผยแพร่แอป จะมีเพียงบัญชีทดสอบที่แสดงใน Google Play Console เท่านั้นที่เข้าสู่ระบบได้ อย่างไรก็ตาม เมื่อเผยแพร่แอปพลิเคชันแล้ว ทุกคนจะเข้าสู่ระบบได้

ขั้นตอนที่ 3: แก้ไขโค้ด

หากต้องการเรียกใช้เกม คุณต้องกำหนดค่ารหัสแอปพลิเคชันเป็นทรัพยากรในโปรเจ็กต์ Android นอกจากนี้ คุณจะต้องเพิ่มข้อมูลเมตาของเกมใน AndroidManifest.xml ด้วย

1. เปิด res/values/ids.xml แล้วแทนที่รหัสตัวยึดตำแหน่ง หากคุณสร้างเกม Android ใหม่ตั้งแต่ต้น คุณจะต้องสร้างไฟล์นี้ก่อน
   1. ระบุรหัสแอปพลิเคชันในทรัพยากร app_id
   2. ระบุรหัสรางวัลพิเศษแต่ละรหัสที่คุณสร้างขึ้นก่อนหน้านี้ในทรัพยากร achievement_* ที่เกี่ยวข้อง
   3. ระบุรหัสลีดเดอร์บอร์ดแต่ละรายการที่คุณสร้างไว้ก่อนหน้านี้ในทรัพยากร leaderboard_* ที่เกี่ยวข้อง
2. เปิด AndroidManifest.xml แล้วป้อนชื่อแพ็กเกจในแอตทริบิวต์ package ขององค์ประกอบ <manifest> หากคุณสร้างเกม Android ขึ้นใหม่ตั้งแต่ต้น อย่าลืมเพิ่มโค้ดต่อไปนี้ภายในองค์ประกอบ <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 ทำงานได้อย่างถูกต้องในเกม

วิธีเรียกใช้เกมในอุปกรณ์ทดสอบจริง

1. ตรวจสอบว่าคุณได้ตั้งค่าบัญชีทดสอบที่ใช้เข้าสู่ระบบแอปแล้ว (ตามที่อธิบายไว้ในขั้นตอนที่ 2)
2. ส่งออก APK และลงนามด้วยใบรับรองเดียวกับที่คุณใช้ตั้งค่าโปรเจ็กต์ใน Google Play Console หากต้องการส่งออก APK ที่เซ็นชื่อใน Android Studio ให้คลิกสร้าง > สร้าง APK ที่เซ็นชื่อ
3. ติดตั้ง APK ที่ลงนามแล้วในอุปกรณ์ทดสอบจริงโดยใช้เครื่องมือ adb ดูวิธีติดตั้งแอปพลิเคชันได้ที่การทํางานบนอุปกรณ์