ตั้งค่าบริการเกมของ Google Play

หน้านี้อธิบายวิธีตั้งค่าบริการ Google Play Games สำหรับเกม Android โดยใช้ Google Play Console Play Console เป็นศูนย์กลางในการจัดการบริการเกมและกำหนดค่าข้อมูลเมตาที่ใช้เพื่อให้สิทธิ์และตรวจสอบสิทธิ์เกม

หากต้องการเพิ่มเกมลงใน Play Console ให้ทำตามขั้นตอนทั่วไปต่อไปนี้

• สร้างโปรเจ็กต์เกมสำหรับเกมของคุณและระบุรายละเอียด เช่น ชื่อและคำอธิบายของเกม

• สร้างและลิงก์ข้อมูลเข้าสู่ระบบที่จำเป็นเพื่อให้สิทธิ์และตรวจสอบสิทธิ์เกมกับบริการเกมของ Google Play

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

ทําตามขั้นตอนต่อไปนี้ให้เรียบร้อยก่อนที่จะกําหนดค่าบริการ Google Play Games

สร้างบัญชีนักพัฒนาแอป Google Play

• คุณต้องตั้งค่าบัญชีนักพัฒนาแอป Google Play ใน Play Console ดูข้อมูลเพิ่มเติมได้ที่ลงทะเบียนบัญชีนักพัฒนาแอป Google Play

• ให้สิทธิ์แก้ไข: หากต้องการแก้ไขการตั้งค่าบริการเกมของ Play ใน Play Console ทีมของคุณต้องมีสิทธิ์จัดการบริการเกมของ Play ดูข้อมูลเพิ่มเติมได้ที่เพิ่มผู้ใช้บัญชีนักพัฒนาแอปและจัดการสิทธิ์

สร้างโปรเจ็กต์ Google Cloud

คุณต้องตั้งค่าโปรเจ็กต์ Google Cloud แล้ว ดูข้อมูลเพิ่มเติมได้ที่

• เริ่มต้นใช้งาน Google Cloud
• การสร้างโปรเจ็กต์

หากต้องการใช้ Play Console คุณต้องเปิดใช้ API ที่คุณวางแผนจะใช้กับโปรเจ็กต์

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

ลงชื่อเข้าใช้ Play Console

หากต้องการลงชื่อเข้าใช้ ให้ไปที่ Google Play Console หากยังไม่ได้ลงทะเบียน Play Console มาก่อน ระบบจะแจ้งให้คุณดำเนินการ

เพิ่มเกมลงใน Play Console

หากต้องการเพิ่มเกม ให้ทำตามขั้นตอนต่อไปนี้

1. สร้างแอปและระบุว่าเป็นแอปเกมใน Play Console ดูข้อมูลเพิ่มเติมได้ที่สร้างและตั้งค่าแอป

2. ไปที่ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > การกําหนดค่า

3. ระบุว่าเกมของคุณใช้ Google APIs (เช่น Firebase) อยู่แล้วหรือไม่ คุณจึงควรเลือกตัวเลือกที่ถูกต้อง ไม่เช่นนั้นเกมอาจพบปัญหาเมื่อใช้ Google APIs ตัวเลือกมีดังนี้

   • ไม่ เกมของฉันไม่ได้ใช้ Google APIs: เลือกตัวเลือกนี้หากคุณกำลังสร้างเกมใหม่หรือไม่เคยตั้งค่า Google API ให้กับเกม ป้อนชื่อเกมแล้วคลิกสร้าง

   • ใช่ เกมของฉันใช้ Google APIs อยู่แล้ว: เลือกตัวเลือกนี้หากคุณตั้งค่า Google API สําหรับเกมไว้แล้ว ในกรณีนี้ คุณจะเห็นรายการโปรเจ็กต์จาก Google Cloud Console เลือกโปรเจ็กต์จากรายการ แล้วคลิกใช้

   • ใช้โปรเจ็กต์บริการเกมของ Play ที่มีอยู่แล้ว: หากต้องการใช้โปรเจ็กต์บริการเกมของ Play ที่มีอยู่แล้ว ให้เลือกตัวเลือกนี้ คุณจะเห็นรายการโปรเจ็กต์บริการเกมของ Play ที่มีอยู่ในบัญชี เลือกโปรเจ็กต์เกมจากรายการ แล้วคลิกใช้ ตัวเลือกนี้ไม่ใช่ตัวเลือกทั่วไป แต่คุณอาจใช้ตัวเลือกนี้หากกำลังสร้างเกมใหม่ใน Play Console เพื่อเปลี่ยนชื่อแพ็กเกจ หรือหากมีเกมเวอร์ชันฟรีและเวอร์ชันที่ต้องซื้อซึ่งใช้ชื่อแพ็กเกจไม่เหมือนกัน

   ระบบจะสร้างโปรเจ็กต์เกมบริการเกมของ Play และสร้างรายการที่เกี่ยวข้องให้คุณในคอนโซล Google Cloud

4. ในส่วนพร็อพเพอร์ตี้ ให้คลิกแก้ไขพร็อพเพอร์ตี้เพื่อเพิ่มข้อมูล เช่น คำอธิบาย หมวดหมู่ และชิ้นงานกราฟิกสำหรับเกม ต่อไปนี้คือหลักเกณฑ์ในการกำหนดค่าพร็อพเพอร์ตี้

   • สำหรับการทดสอบ คุณต้องใช้เพียงชื่อที่แสดงเท่านั้น คุณต้องกรอกข้อมูลในช่องอื่นๆ ก่อนจึงจะเผยแพร่เกมได้

   • ชื่อที่แสดงและคำอธิบายของเกมควรตรงกับที่คุณตั้งค่าไว้ในข้อมูลผลิตภัณฑ์ใน Play Store ของเกม

   • ดูหลักเกณฑ์เกี่ยวกับการสร้างชิ้นงานกราฟิกได้ที่หัวข้อเพิ่มเนื้อหาตัวอย่างเพื่อแสดงแอปของคุณและหลักเกณฑ์รูปภาพแนะนำของ Google Play

สร้างรหัสไคลเอ็นต์ OAuth 2.0

เกมของคุณต้องมีรหัสไคลเอ็นต์ OAuth 2.0 จึงจะได้รับการตรวจสอบสิทธิ์และได้รับอนุญาตให้เรียกใช้บริการ Google Play Games หากต้องการตั้งค่าข้อมูลเข้าสู่ระบบสำหรับบริการ Play Games ซึ่งเป็นการเชื่อมโยงระหว่างรหัสไคลเอ็นต์กับเกมของคุณ ให้ใช้ Google Cloud Platform เพื่อสร้างรหัสไคลเอ็นต์ จากนั้นใช้ Google Play Console เพื่อเพิ่มข้อมูลเข้าสู่ระบบโดยลิงก์รหัสไคลเอ็นต์กับเกม

ดูวิธีการโดยละเอียดได้ที่ขั้นตอนต่อไปนี้

กำหนดค่าหน้าจอขอความยินยอม OAuth

หากยังไม่ได้กําหนดค่าหน้าจอคํายินยอม OAuth ส่วนข้อมูลเข้าสู่ระบบจะแสดงข้อความแจ้งให้คุณกําหนดค่า

คลิกกำหนดค่า ซึ่งจะเป็นการเปิดกล่องโต้ตอบพร้อมวิธีการเพิ่มเติมและลิงก์ไปยัง Google Cloud Platform

ตรวจสอบว่าหน้าจอขอความยินยอมพร้อมใช้งานสำหรับทุกคนที่เล่นเกมได้ รายการขอบเขตสุดท้ายต้องมี games, games_lite และ drive.appdata โดยขอบเขตเหล่านี้ไม่จําเป็นต้องได้รับการยืนยันแอป เราขอแนะนำให้เผยแพร่หน้าจอขอความยินยอมทันที หากไม่สามารถทำได้ คุณสามารถทำให้ผู้ทดสอบเห็นหน้าจอขอความยินยอมเพื่อให้ลงชื่อเข้าใช้เกมได้

หากตั้งค่าหน้าจอขอความยินยอม OAuth เสร็จแล้ว ให้คลิกเสร็จสิ้น Google Play Console จะรีเฟรชโดยอัตโนมัติ และหากการกําหนดค่าสําเร็จ คุณก็จะสร้างข้อมูลเข้าสู่ระบบได้ ดังนี้

สร้างข้อมูลเข้าสู่ระบบ

หากต้องการให้สิทธิ์เกมสื่อสารกับบริการเกมของ Google Play คุณต้องสร้างข้อมูลเข้าสู่ระบบที่มีรหัสไคลเอ็นต์ OAuth2 ที่ได้รับอนุญาต

ในส่วนข้อมูลเข้าสู่ระบบ ให้คลิกเพิ่มข้อมูลเข้าสู่ระบบ

ในวิซาร์ด ให้เลือกว่าต้องการสร้างข้อมูลเข้าสู่ระบบ Android (หาก APK เกมจะตรวจสอบสิทธิ์ผู้ใช้และใช้ API บริการเกมของ Play) หรือข้อมูลเข้าสู่ระบบเซิร์ฟเวอร์เกม (หากเซิร์ฟเวอร์เกมจะใช้ API บริการเกมของ Play) ทำตามวิธีการสำหรับประเภทข้อมูลเข้าสู่ระบบที่ต้องการ

เปิดใช้การทดสอบ

คุณควรทดสอบบริการเกมก่อนเผยแพร่การเปลี่ยนแปลงเกมใน Google Play เพื่อให้มั่นใจว่าบริการ Google Play Games ทำงานได้อย่างถูกต้องในเกม

หากเกมอยู่ในสถานะ "ยังไม่ได้เผยแพร่" ให้มอบสิทธิ์เข้าถึงแก่ผู้ทดสอบโดยเพิ่มบัญชีผู้ใช้ของผู้ทดสอบลงในรายการที่อนุญาต มิเช่นนั้น ผู้ทดสอบจะพบข้อผิดพลาด OAuth และ 404 เมื่อพยายามเข้าถึงปลายทางของบริการเกมของ Play เช่น ปลายทางการลงชื่อเข้าใช้

ผู้ใช้ที่มีบัญชีทดสอบที่ได้รับอนุญาตจะมีสิทธิ์เข้าถึงโปรเจ็กต์เกมบริการเกมของ Play ที่ไม่ได้เผยแพร่ และสามารถทดสอบว่าบริการเกมของ Play ที่คุณกำหนดค่าไว้ทํางานได้อย่างถูกต้อง

การเปิดใช้ API บริการเกมของ Play ให้ผู้ทดสอบใช้กับเกมของคุณทำได้ 2 วิธีดังนี้

• ในระดับบุคคล โดยเพิ่มอีเมลของแต่ละคน

• ที่ระดับกลุ่ม โดยการเปิดใช้บริการเกมของ Play สำหรับแทร็กการเผยแพร่ของ Play Console

วิธีเพิ่มผู้ทดสอบแต่ละคนลงในโปรเจ็กต์เกม

1. เปิดแท็บผู้ทดสอบสำหรับเกมใน Google Play Console (เติบโต > บริการเกมของ Play > การตั้งค่าและการจัดการ > ผู้ทดสอบ)
2. คลิกปุ่มเพิ่มผู้ทดสอบ
3. ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ป้อนอีเมลของบัญชี Google ที่ต้องการเพิ่มเป็นผู้ทดสอบ (คั่นด้วยคอมมาหรืออีเมล 1 รายการต่อบรรทัด)
4. คลิกเพิ่มเพื่อบันทึกผู้ใช้เป็นผู้ทดสอบ บัญชีผู้ทดสอบที่คุณเพิ่มควรจะเข้าถึงบริการเกมของ Play ได้ภายใน 2-3 ชั่วโมง

หากต้องการให้สิทธิ์เข้าถึงการทดสอบแก่กลุ่ม ให้เปิดใช้แทร็กรุ่นเพื่อเข้าถึงบริการเกมของ Play โดยทำดังนี้

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

คุณสามารถให้สิทธิ์เข้าถึงการทดสอบเกมแก่ผู้ใช้ทุกคนที่มีสิทธิ์เข้าถึง APK ทดสอบในแทร็กรุ่นที่ระบุ ซึ่งจะทํางานเหมือนกับการที่คุณเพิ่มผู้ใช้ไปยังรายชื่อผู้ทดสอบทีละคน โดยคุณต้องทำตามขั้นตอนต่อไปนี้:

1. เปิดส่วนผู้ทดสอบ PGS (เติบโต > บริการเกมของ Play > การตั้งค่าและการจัดการ > ผู้ทดสอบ) และคัดเลือกแท็บติดตามการเผยแพร่ ในหน้านี้ คุณยังจะเห็นรายการแทร็กที่เปิดใช้สำหรับการทดสอบบริการ Play Games อยู่แล้วด้วย
2. คลิกเพิ่มแทร็ก
3. เลือกแทร็กอย่างน้อย 1 แทร็กเพื่อเปิดใช้การทดสอบบริการเกมของ Play
4. คลิกเพิ่มแทร็ก

ตอนนี้แทร็กรุ่นที่เลือกจะปรากฏในรายการแทร็กที่ใช้ทดสอบบริการเกมของ Play ได้

ฟีเจอร์นี้ใช้ได้เฉพาะในกรณีที่คุณมีแอป Android ที่ลิงก์กับเกมใน Google Play Console

หลีกเลี่ยงปัญหาที่พบได้ทั่วไป

โปรดทำตามคำแนะนำเหล่านี้เมื่อตั้งค่าเกมให้ใช้บริการ Google Play Games เพื่อหลีกเลี่ยงข้อผิดพลาดที่พบได้ทั่วไป

1. ตั้งค่าเกมด้วย Play Console

หากคุณสร้างรหัสไคลเอ็นต์ OAuth 2.0 สําหรับแอปในคอนโซล Google Cloud บริการเกมของ Google Play จะไม่ทราบว่ามีการเชื่อมโยงระหว่างรางวัลและกระดานผู้นำของเกมกับรหัสไคลเอ็นต์ หากต้องการสร้างการเชื่อมโยงนี้ คุณต้องสร้างข้อมูลเข้าสู่ระบบโดยใช้รหัสไคลเอ็นต์ OAuth 2.0 ตามที่อธิบายไว้ในสร้างข้อมูลเข้าสู่ระบบ

2. ใช้รหัสแอปพลิเคชันที่ถูกต้องใน Android

รหัสแอปพลิเคชันคือทรัพยากรสตริงที่ต้องระบุซึ่งคุณต้องอ้างอิงในไฟล์ Manifest ของ Android สตริงรหัสแอปพลิเคชันประกอบด้วยตัวเลขเท่านั้น (โดยปกติแล้วจะมี 12 หลักขึ้นไป) ที่ขึ้นต้นของรหัสไคลเอ็นต์ที่ Play Console ระบุ รหัสแอปพลิเคชันจะอยู่ที่ด้านบนของหน้าการกําหนดค่าและมีป้ายกำกับเป็นรหัสโปรเจ็กต์ใต้ชื่อเกม

3. รับรอง APK ด้วยใบรับรองที่ถูกต้อง

เมื่อลิงก์แอป Android กับเกมใน Play Console คุณต้องใช้ชื่อแพ็กเกจและลายนิ้วมือใบรับรองเดียวกันกับที่ใช้เผยแพร่แอป หากไม่ตรงกัน การเรียกใช้บริการ Google Play Games จะดำเนินการไม่สำเร็จ คุณควรสร้างรหัสไคลเอ็นต์ 2 รายการ โดยรหัสหนึ่งมีลายนิ้วมือใบรับรองรุ่น และอีกรหัสหนึ่งมีลายนิ้วมือใบรับรองสำหรับการแก้ไขข้อบกพร่อง และใช้ชื่อแพ็กเกจเดียวกันสำหรับทั้ง 2 รหัส ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีระบุใบรับรองการรับรองใน Play Console ได้ที่การรับรองแอปพลิเคชันของคุณ

4. เมื่อพัฒนาแอปสำหรับ Android ให้รวม Play Games SDK เป็นโปรเจ็กต์ไลบรารี ไม่ใช่ JAR แบบสแตนด์อโลน

ตรวจสอบว่ามีการอ้างอิง SDK ของบริการ Google Play เป็นโปรเจ็กต์ไลบรารีในโปรเจ็กต์ Android มิเช่นนั้นอาจทำให้เกิดข้อผิดพลาดเมื่อแอปไม่พบทรัพยากรของบริการ Google Play ดูวิธีตั้งค่าโปรเจ็กต์ Android ให้ใช้บริการ Google Play ได้ที่การตั้งค่าบริการ Google Play

5. ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบระหว่างการพัฒนา

หากคุณยังไม่ได้เผยแพร่การเปลี่ยนแปลงการตั้งค่าเกมใน Play Console คุณอาจพบข้อผิดพลาดระหว่างการทดสอบหากไม่ได้ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบที่อยู่ในรายการที่อนุญาต คุณควรเปิดใช้บัญชีผู้เผยแพร่โฆษณา Play Console สำหรับการทดสอบเสมอ ดูวิธีจัดการบัญชีผู้ทดสอบได้ที่การเปิดใช้บัญชีสำหรับการทดสอบ

6. เผยแพร่หน้าจอขอความยินยอมใน Google Cloud Platform

ก่อนเผยแพร่แอปใน Play Console ให้เผยแพร่หน้าจอขอความยินยอมใน Google Cloud Platform หากไม่ทำขั้นตอนนี้ กลุ่มเป้าหมายสาธารณะจะใช้ฟีเจอร์ใดๆ ของบริการเกมของ Play ไม่ได้

7. เมื่อเผยแพร่ ให้เผยแพร่การตั้งค่าบริการเกมของ Play ก่อนเผยแพร่เกม

นักพัฒนาแอปอาจเผยแพร่แอปโดยไม่เผยแพร่การตั้งค่าบริการเกมของ Play ที่เกี่ยวข้องของแอปโดยไม่ได้ตั้งใจ ซึ่งอาจทำให้ผู้เล่นที่ลงชื่อเข้าใช้ด้วยบัญชีที่ไม่ใช่บัญชีผู้ทดสอบพบข้อผิดพลาดเนื่องจากแอปไม่สามารถอ้างอิงการตั้งค่าเกมที่ถูกต้อง เมื่อเผยแพร่เกม อย่าลืมเผยแพร่การตั้งค่าเกมก่อนโดยใช้ตัวเลือกเผยแพร่เกมใน Play Console ดูวิธีเผยแพร่การเปลี่ยนแปลงได้ที่การเผยแพร่การเปลี่ยนแปลงในเกม

ดูเคล็ดลับเพิ่มเติมได้ในคู่มือการแก้ปัญหา Android

ขั้นตอนถัดไป

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