เริ่มต้นใช้งานบริการเกมของ 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 Games

กำหนดค่าแอป

ในไฟล์ 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 อื่นๆ วิธีดำเนินการใน Android Studio มีดังนี้
   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 รายการควรใช้การจัดรูปแบบคะแนนแบบจำนวนเต็มโดยไม่มีจุดทศนิยม และประเภทการจัดเรียงเป็นยิ่งมากยิ่งดี
   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 ดูวิธีติดตั้งแอปพลิเคชันได้ที่การทํางานบนอุปกรณ์