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

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

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

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

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

หากต้องการเตรียมแอป ให้ทำตามขั้นตอนในส่วนต่อไปนี้

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

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

  • สูงขึ้น 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.1.0'
  }

ตัวอย่างคู่มือแอป

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

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

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

วิธีดาวน์โหลดและตั้งค่าแอปพลิเคชันตัวอย่างใน 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 ในแอปหรือไม่ ให้เลือกฉันยังไม่มี Google API ในเกมของฉัน
    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 ทั้งสองโหมด ไม่มี
      สุดยอดไปเลย! ได้รับคะแนน 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 จาก 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 หากต้องการเรียนรู้วิธีติดตั้งแอปพลิเคชัน โปรดดู การทำงานในอุปกรณ์