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

ยินดีต้อนรับสู่การพัฒนาเกม 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 ให้ทำดังนี้

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

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

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