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

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

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

การฝึกอบรมนี้จะแนะนำให้คุณติดตั้งแอปพลิเคชันเกมตัวอย่างสำหรับ Android และเริ่มต้นสร้างเกม Android ของคุณเองได้อย่างรวดเร็ว แอปตัวอย่างชาเลนจ์ประเภท A-Number จะสาธิตวิธีการผสานรวมรางวัลพิเศษและลีดเดอร์บอร์ดลงในเกม

ก่อนเริ่มต้น

ทําตามขั้นตอนในส่วนต่อไปนี้เพื่อเตรียมแอป

ข้อกำหนดเบื้องต้นของแอป

ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้

• สูงกว่า 19 minSdkVersion
• 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 ของคุณเองได้อย่างรวดเร็ว แอปตัวอย่างชาเลนจ์ประเภท A-Number จะสาธิตวิธีการผสานรวมรางวัลพิเศษและลีดเดอร์บอร์ดลงในเกม

ขั้นตอนที่ 1: ดาวน์โหลดแอปตัวอย่าง

สำหรับคู่มือนักพัฒนาซอฟต์แวร์นี้ คุณจะต้องดาวน์โหลดตัวอย่างแอปพลิเคชัน Android ประเภทa-Number Challenge

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

1. ดาวน์โหลดตัวอย่าง Android จากหน้าดาวน์โหลดตัวอย่าง
2. นำเข้าโปรเจ็กต์ android-basic-samples โครงการนี้มี TypeANumber และเกมตัวอย่างอื่นๆ ของ Android ใน Android Studio ให้ทำดังนี้
   1. คลิกไฟล์ > นำเข้าโปรเจ็กต์
   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 สำหรับเกม รวมถึงกำหนดค่าข้อมูลเมตาสำหรับการให้สิทธิ์และตรวจสอบสิทธิ์ของเกม

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

1. ชี้เว็บเบราว์เซอร์ไปที่ Google Play Console แล้วลงชื่อเข้าใช้ หากคุณยังไม่เคยลงทะเบียน Google Play Console มาก่อน คุณจะได้รับข้อความแจ้งให้ดำเนินการ
2. ทำตามวิธีการเหล่านี้เพื่อเพิ่มเกมลงใน Google Play Console
   1. เมื่อระบบถามว่าคุณใช้ Google APIs ในแอปหรือไม่ ให้เลือกฉันยังไม่เคยใช้ API ของ Google ในเกมของฉัน
   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. เพิ่มรางวัลพิเศษตัวอย่างต่อไปนี้

      ชื่อ	คำอธิบาย	คำขอพิเศษ
      Prime	ได้คะแนนเป็นจำนวนเฉพาะ	ไม่มี
      อ่อนน้อม	ขอคะแนน 0	ไม่มี
      อย่าอ้วนนะเด็ก	ขอคะแนน 9999 ในทั้ง 2 โหมด	ไม่มี
      สุดยอดผู้ใช้!	ได้รับคะแนน 1337 คะแนน	ทำให้รายการนี้เป็นรางวัลพิเศษที่ซ่อนอยู่
      เบื่อ	เล่นเกม 10 ครั้ง	ทำให้รายการนี้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ ด้วย 10 ขั้นตอนในการปลดล็อก
      เบื่อมากจริงๆ	เล่นเกม 100 ครั้ง	ทำให้เกมนี้เป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ ด้วย 100 ขั้นตอนในการปลดล็อก

   3. บันทึกรหัส (สตริงอักขระที่เป็นตัวอักษรและตัวเลขคละกันยาว) สำหรับรางวัลพิเศษแต่ละรายการที่คุณสร้าง
   4. กำหนดค่ารางวัลพิเศษที่เหมาะกับเกมของคุณ ดูข้อมูลเพิ่มเติมได้ในแนวคิดเบื้องหลังรางวัลพิเศษและวิธีใช้รางวัลพิเศษใน Android
6. กำหนดค่าลีดเดอร์บอร์ดสำหรับความท้าทายประเภท a-Number ดังนี้
   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 จาก 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

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

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