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

หลังจากเลิกใช้งาน API ของ Google Sign-In แล้ว เราจะนำ SDK v1 ของเกมออกในปี 2026 หลังจากเดือนกุมภาพันธ์ 2025 คุณจะเผยแพร่ เกมที่เพิ่งผสานรวมกับ SDK v1 ของ Games ใน Google Play ไม่ได้ เราขอแนะนำให้ใช้ SDK v2 ของ Games แทน
แม้ว่าเกมที่มีอยู่ซึ่งผสานรวมกับเกมเวอร์ชัน 1 ก่อนหน้าจะยังคงทำงานได้อีก 2-3 ปี แต่เราขอแนะนำให้คุณย้ายข้อมูลไปยัง v2 ตั้งแต่เดือนมิถุนายน 2025 เป็นต้นไป
คู่มือนี้มีไว้สำหรับการใช้ SDK บริการเกมของ Play เวอร์ชัน 1 ดูข้อมูล เกี่ยวกับ SDK เวอร์ชันล่าสุดได้ที่ เอกสารประกอบ v2

ยินดีต้อนรับสู่การพัฒนาเกม 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 Central ไว้ในทั้งส่วน buildscript และ allprojects

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

เพิ่มทรัพยากร Dependency ของ Google Play Services สำหรับ 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 สำหรับเกมของคุณ และ กำหนดค่าข้อมูลเมตาสำหรับการให้สิทธิ์และตรวจสอบสิทธิ์เกม

วิธีตั้งค่าเกมตัวอย่างใน 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 หลักขึ้นไป) ที่จุดเริ่มต้นของ Client-ID
   2. ใบรับรองการลงนาม: โปรดทราบว่าคุณใช้ใบรับรองใดเมื่อตั้งค่า การเข้าถึง API (ใบรับรองที่มีลายนิ้วมือ SHA1 ที่คุณระบุ) คุณควรใช้ใบรับรองเดียวกันเพื่อลงนามในแอปเมื่อทดสอบหรือเผยแพร่แอป
5. กำหนดค่าความสำเร็จสำหรับความท้าทาย "พิมพ์ตัวเลข" ดังนี้
   1. เลือกแท็บรางวัลพิเศษใน Google Play Console
   2. เพิ่มรางวัลพิเศษตัวอย่างต่อไปนี้

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