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

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

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

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

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

สำหรับคู่มือนักพัฒนาซอฟต์แวร์นี้ คุณจะต้องดาวน์โหลดตัวอย่างการท้าทาย Type-a-Number แอปพลิเคชัน 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 เพื่อทำสิ่งต่อไปนี้ได้ สร้างคีย์สโตร์และใบรับรองที่ลงชื่อใหม่แล้ว ถ้าคุณยังไม่มี ดูวิธีการ เรียกใช้วิซาร์ดสร้าง 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 รายการ โดยรายการหนึ่งชื่อ "Easy High Score" และอีกรายการหนึ่ง ชื่อ “คะแนนสูง” ลีดเดอร์บอร์ดทั้ง 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 หากต้องการดูวิธีติดตั้งแอปพลิเคชัน โปรดดู ทำงานในอุปกรณ์