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

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

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

การฝึกอบรมนี้จะแนะนําวิธีติดตั้งแอปพลิเคชันเกมตัวอย่างสําหรับ 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()
    }
  }

เพิ่มการอ้างอิงบริการ 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: ดาวน์โหลดแอปตัวอย่าง

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

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