โปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC เป็นโปรแกรมจําลองสําหรับนักพัฒนาซอฟต์แวร์สําหรับ Google Play Games บน PC สิ่งที่แตกต่างจากโปรแกรมเล่นวิดีโอ ก็คือคุณสามารถติดตั้งและ แก้ไขข้อบกพร่องของแพ็กเกจของคุณเอง คุณยังจำลองการกำหนดค่าโปรแกรมเล่นแบบต่างๆ เช่น สัดส่วนภาพ การจำลองเมาส์ และกราฟิกแบ็กเอนด์เพื่อช่วยคุณ ตรวจสอบว่าเกมทำงานได้ตามที่คาดไว้ใน PC หลากหลายประเภท การกำหนดค่าเอง
การเริ่มโปรแกรมจำลอง
เมื่อติดตั้งแล้ว คุณจะมี "โปรแกรมจำลองสำหรับนักพัฒนาแอป Google Play Games" เริ่มต้น เอลิเมนต์เมนูและทางลัดบนเดสก์ท็อปเพื่อเปิดใช้งานโปรแกรมจำลอง โปรแกรมจำลองจะ จะยังคงอยู่ในถาดระบบเมื่อคุณปิดหน้าต่าง
ลงชื่อเข้าใช้
ระบบจะขอให้คุณลงชื่อเข้าใช้บัญชี Google ในครั้งแรกที่คุณเรียกใช้ โปรแกรมจำลอง ใช้ข้อมูลเข้าสู่ระบบเดียวกันกับที่คุณวางแผนจะใช้ในการพัฒนา
คุณสามารถออกจากระบบโดยคลิกขวาที่ไอคอนถาดระบบ แล้วเลือก นักพัฒนาซอฟต์แวร์ ตัวเลือก แล้วคลิกบังคับให้ออกจากระบบ เมื่อดำเนินการดังกล่าว โปรแกรมจำลอง จะรีสตาร์ททันทีและขอให้คุณลงชื่อเข้าใช้อีกครั้ง
การไปยังรายการต่างๆ
หลังจากเปิดตัวแล้ว คุณจะเห็นหน้าจอหลักของ Android ทั่วไป เมาส์ซ้าย การคลิกจะได้รับการแปลโดยตรงเป็นการแตะด้วยนิ้วเช่นเดียวกับในโหมดการจำลองด้วยเมาส์ เกมไซด์โหลดสำหรับการพัฒนาจะปรากฏในรายการแอปพลิเคชัน ซึ่งคุณสามารถ โดยการคลิกและลากบนเดสก์ท็อป (จำลองการปัดขึ้นด้านบน โทรศัพท์หรือแท็บเล็ต)
นอกจากการแปลด้วยเมาส์แล้ว โปรแกรมจําลองสําหรับนักพัฒนาแอปของ Google Play Games บน PC ยังมี แป้นพิมพ์ลัดเพื่อปรับปรุงการนำทาง:
ctrl + h : กดปุ่มหน้าแรกctrl + b : กดปุ่มย้อนกลับF11 หรือAlt + Enter : สลับระหว่างโหมดเต็มหน้าจอกับ โหมดหน้าต่างShift + Tab : เปิดการวางซ้อน Google Play Games บน PC ซึ่งรวมถึง การแมปคีย์ปัจจุบันสำหรับ SDK อินพุต
การติดตั้งเกม
โปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC ใช้ Android Debug Bridge (adb) เพื่อ ติดตั้งแพ็กเกจ
ความเข้ากันได้ของ adb
เวอร์ชันปัจจุบันของ adb
เข้ากันได้กับโปรแกรมจําลองสําหรับนักพัฒนาแอปของ Google Play Games บน PC
นอกจากนี้จะมีการติดตั้งเวอร์ชันที่เข้ากันได้ไว้ที่ C:\Program
Files\Google\Play Games Developer Emulator\current\emulator
เมื่อคุณติดตั้ง
โปรแกรมจำลอง
หากต้องการทำตามวิธีการเหล่านี้ adb ควรมีให้ใช้งานใน $PATH
ของคุณ คุณสามารถ
ตรวจสอบว่าได้กำหนดค่า adb
อย่างถูกต้องด้วยคำสั่ง adb devices
adb devices
List of devices attached
localhost:6520 device
ติดตั้งเกม
- เปิด
Google Play Games for PC Emulator
พิมพ์
adb devices
ใน Command Prompt คุณควรจะเห็นสิ่งต่อไปนี้adb devices List of devices attached localhost:6520 device
การแก้ปัญหา:
- หากคุณได้รับข้อผิดพลาด ให้ตรวจสอบว่าคุณได้ทำตามวิธีการใน Adb แล้ว ความเข้ากันได้
- หากไม่เห็นอุปกรณ์ ให้พยายามเชื่อมต่ออีกครั้งผ่านพอร์ต
6520
adb connect localhost:6520
พิมพ์
adb install path\to\your\game.apk
เพื่อติดตั้งเกม หากคุณได้ สร้าง Android App Bundle (aab) แล้ว โปรดดูวิธีการสำหรับ bundletool และใช้bundletool install-apks
แทนเรียกใช้เกมด้วยวิธีใดวิธีหนึ่งต่อไปนี้
- พิมพ์
adb shell monkey -p your.package.name 1
เพื่อเล่นเกม โดยแทนที่your.package.name
ด้วยชื่อแพ็กเกจของเกม - ในโปรแกรมจำลองสำหรับนักพัฒนาซอฟต์แวร์ Google Play Games บน PC ให้คลิกไอคอนเพื่อเล่นเกม คุณต้อง "เลื่อนขึ้น" เช่นเดียวกับในโทรศัพท์ Android ในบ้าน เพื่อดูรายการเกมที่ติดตั้ง
- พิมพ์
การแก้ไขข้อบกพร่องของเกม
ใช้ Android Debug Bridge (adb) เพื่อแก้ไขข้อบกพร่องเช่นเดียวกับเกมอื่นๆ
โปรแกรมจำลองจะปรากฏเป็นอุปกรณ์ที่เชื่อมต่อผ่าน localhost:6520
adb logcat
ทำงานได้ตามที่คาดไว้ เช่นเดียวกับเครื่องมือที่ช่วยปรับแต่งหรือกรอง
เอาต์พุต logcat รวมถึง Android Studio
นอกจาก adb
แล้ว คุณยังเข้าถึงบันทึกได้ใน
ไดเรกทอรี %LOCALAPPDATA%\Google\Play Games Developer Emulator\Logs
พบบ่อยที่สุด
มีประโยชน์ที่นี่คือ AndroidSerial.log
ซึ่งแสดงถึงทุกอย่างที่ adb logcat
จะเกิดเสียงสะท้อนทันทีที่โปรแกรมจำลองเริ่มทำงาน
การตั้งค่าสำหรับนักพัฒนาแอป
โปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC มุ่งเน้นที่ประสิทธิภาพของนักพัฒนาซอฟต์แวร์มากกว่า มากกว่าประสบการณ์ของผู้ใช้ปลายทาง หมายความว่าคุณมีสิทธิ์เข้าถึง Android ซึ่งรวมถึงการใช้ Android Launcher มาตรฐานแทน ประสบการณ์การใช้งาน Google Play Games บน PC และการควบคุมฟีเจอร์ต่างๆ มิฉะนั้น ผู้เล่นจะเปิดใช้และปิดใช้งานโดยอัตโนมัติ
การทดสอบการป้อนข้อมูลด้วยเมาส์
ในระหว่างการพัฒนา โปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC จะแตะเป็นค่าเริ่มต้น แทนการป้อนอินพุตด้วยเมาส์โดยตรง คุณเปิดใช้เมาส์โดยตรงได้ ได้โดยคลิกขวาที่ไอคอนถาดระบบ เลือกตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ แล้วเลือกโหมด PC (KiwiMouse)
Google Play Games บน PC มีโหมดเมาส์ 2 โหมด ได้แก่ โหมดจำลองที่แปลภาษา คลิกเมาส์ด้วยการแตะเพียงครั้งเดียว และส่งผ่าน "โหมด PC" ที่ช่วยให้เกมจัดการ การทำงานของเมาส์ตั้งแต่ต้น และดำเนินการจับเคอร์เซอร์ สำหรับรายละเอียดเกี่ยวกับการป้อนข้อมูลด้วยเมาส์ ใน Google Play Games บน PC ให้ดูที่ตั้งค่าการป้อนข้อมูลด้วยเมาส์
ในไคลเอ็นต์โปรแกรมเล่น การจำลองจะถูกปิดใช้โดยการเพิ่มรายการนี้ลงในไฟล์ Manifest ของคุณ
<manifest ...>
<uses-feature
android:name="android.hardware.type.pc"
android:required="false" />
...
</manifest>
แฟล็กฟีเจอร์นี้จะไม่ส่งผลใดๆ ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์
กำลังทดสอบสัดส่วนภาพ
โปรแกรมจำลองสำหรับนักพัฒนาซอฟต์แวร์เปิดตัวในสัดส่วนภาพ 16:9 ซึ่งจะแตกต่างจากโปรแกรมเล่นวิดีโอ ไคลเอ็นต์ที่ได้สัดส่วนภาพมาจากจอแสดงผลหลัก ทางขวา คลิกไอคอนถาดระบบ เลือกตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ จากนั้นเลือก ในส่วนอัตราส่วนการแสดงผล คุณสามารถทดสอบว่าเกมมีลักษณะอย่างไร หน้าจอต่างๆ ของโปรแกรมเล่นวิดีโอ
วิธีที่แนะนำในการกำหนดค่าสัดส่วนภาพ
คือการใช้ android:minAspectRatio
และ android:maxAspectRatio
ตัวอย่างเช่น
เกมแนวตั้งจะมีสัดส่วนภาพ 9/16
หรือ 0.5625
คุณจึงอาจต้องการ
กำหนดสัดส่วนภาพสูงสุดเป็น 1
เพื่อป้องกันไม่ให้เกมของคุณกว้างกว่าสี่เหลี่ยมจัตุรัส
<activity android:maxAspectRatio="1">
...
</activity>
เกมแนวนอนควรเป็น 16/9
หรือประมาณ 1.778
ในการตั้งค่าสัดส่วนภาพขั้นต่ำ 1
เพื่อป้องกันไม่ให้ดูแคบกว่าสี่เหลี่ยมจัตุรัส
<activity android:minAspectRatio="1">
...
</activity>
สิ่งที่จะทดสอบ
หากเกมรองรับเฉพาะโหมดแนวตั้งในไฟล์ Manifest คุณจะเลือก 9:16 ได้ (แนวตั้ง) ในเมนูแบบเลื่อนลงเพื่อดูลักษณะของวิดีโอที่ปรากฏในผู้เล่น PC กรณีอื่น ตรวจสอบว่าเกมทำงานได้ในอัตราส่วนแนวนอนที่กว้างและแคบที่สุด ในไฟล์ Manifest ของคุณ โดยอย่าลืมว่า 16:9 (ค่าเริ่มต้น) (หรือ 9:16 (แนวตั้ง) หากเกมเป็นแนวตั้งเท่านั้น) ต้องระบุสำหรับ การรับรองเต็มรูปแบบ
การทดสอบแบ็กเอนด์การแสดงผล
Google Play Games บน PC ใช้ ANGLE เป็นเลเยอร์ความเข้ากันได้เพื่อ ตรวจสอบว่าการเรียกใช้ OpenGL ES ได้รับการจัดการอย่างถูกต้องโดยพีซีของโฮสต์โดยใช้ แบ็กเอนด์ DirectX หรือ Vulkan โปรแกรมจำลองยังสนับสนุน Vulkan โดยตรงด้วย แม้ว่า ไม่ใช่ใน DirectX เลเยอร์นี้ยังแปลงรูปแบบพื้นผิวที่บีบอัดสำหรับอุปกรณ์เคลื่อนที่เท่านั้นด้วย ที่ใช้งานกับ PC ได้ โดยคลิกขวาที่ไอคอนถาดระบบ และเลือก การแทนที่สแต็กกราฟิก คุณอาจตั้งค่าเป็นค่าเริ่มต้นของระบบหรือ บังคับเปิดหรือปิด vulkan สำหรับการทดสอบความเข้ากันได้
สิ่งที่จะทดสอบ
มีรูปแบบพื้นผิวที่รองรับอยู่บ้าง และขั้นตอนที่จำเป็น จำลองฟีเจอร์บนอุปกรณ์เคลื่อนที่ต่างๆ บนเดสก์ท็อป เมื่อคุณทำโปรไฟล์และเพิ่มประสิทธิภาพ คุณควรตรวจสอบแบ็กเอนด์แต่ละชุด
การทำโปรไฟล์เกม PC ของคุณ
เนื่องจากโปรแกรมจำลองใช้เทคโนโลยีเดียวกันกับไคลเอ็นต์ของผู้บริโภค สภาพแวดล้อมที่เหมาะสมในการจัดทำโปรไฟล์ประสิทธิภาพ
Perfetto เป็นเครื่องมือสำหรับวิเคราะห์ประสิทธิภาพใน Android คุณสามารถมารวมตัวกัน ดูการติดตาม Perfetto โดยทำตามขั้นตอนต่อไปนี้
ในข้อความแจ้งของ PowerShell ให้เริ่มการติดตามโดยใช้
adb
adb shell perfetto --time 10s gfx wm sched --out /data/misc/perfetto-traces/example.trace
- แฟล็ก
--time
จะระบุระยะเวลาของการติดตามที่จะรวบรวมด้วยวิธีนี้ เช่น การติดตามคือ 10 วินาที - อาร์กิวเมนต์หลังแฟล็ก
--time
ระบุว่าเหตุการณ์ใด มีการติดตาม ในตัวอย่างนี้gfx
หมายถึงกราฟิก การจัดการหน้าต่างwm
และsched
ประมวลผลข้อมูลการตั้งเวลา โดยทั่วไปแล้ว สิ่งที่ควรทำคือทำโปรไฟล์ เกมและข้อมูลอ้างอิงแบบสมบูรณ์ได้ - แฟล็ก
--out
ระบุไฟล์เอาต์พุตซึ่งดึงออกจาก โปรแกรมจำลองลงในเครื่องโฮสต์ในขั้นตอนถัดไป
- แฟล็ก
ดึงการติดตามจากโฮสต์
adb pull /data/misc/perfetto-traces/example.trace $HOME/Downloads/example.trace
เปิดการติดตามใน UI ของ Perfetto
- เปิด ui.perfetto.dev
- เลือกเปิดไฟล์การติดตามจากมุมซ้ายบนในส่วนการนำทาง
- เปิดไฟล์
example.trace
ที่คุณดาวน์โหลดในขั้นตอนก่อนหน้าไปยัง ไดเรกทอรีDownloads/
ตรวจสอบการติดตามใน UI ของ Perfetto ตัวอย่างเคล็ดลับมีดังนี้
- แต่ละกระบวนการจะมีแถวของตนเอง ซึ่งสามารถขยายเพื่อแสดงชุดข้อความทั้งหมดได้ ในกระบวนการนั้น หากคุณกำลังทำโปรไฟล์เกม การประมวลผลของเกมน่าจะเป็นรายการแรก แถว
- คุณสามารถซูมเข้าและออกโดยกด Control ค้างไว้ แล้วใช้การเลื่อน ลูกกลิ้งเมาส์
- เมื่อใช้เหตุการณ์
sched
แต่ละชุดข้อความจะแสดงแถวเมื่อ สถานะของชุดข้อความนั้นกำลังทำงาน เรียกใช้ได้ อยู่ในโหมดสลีป หรือถูกบล็อก - เมื่อเปิดใช้เหตุการณ์ เช่น
gfx
คุณจะสามารถดู การเรียกใช้กราฟิกจากเทรดหลายรายการ คุณสามารถเลือกแต่ละ "ส่วน" ได้ ถึง ดูว่าใช้เวลานานเท่าใด หรือคุณจะลากไปตามแถวเพื่อสร้าง "ส่วนแบ่ง" ก็ได้ ส่วน เพื่อเปิดที่ด้านล่าง และแสดงให้เห็นว่า แต่ละส่วนใช้เวลานานเท่าใด กรอบเวลาที่เลือกไว้
การทำโปรไฟล์กราฟิก
สามารถดำเนินการทำโปรไฟล์กราฟิกบางอย่างกับ RenderDoc
- ตั้งค่าตัวแปรสภาพแวดล้อม
ANDROID_EMU_RENDERDOC
ลงในสตริงที่ไม่ว่างเปล่า (เช่น"1"
) ตั้งค่าตัวแปรสภาพแวดล้อม
TMP
เป็น%USERPROFILE%\AppData\LocalLow
การดำเนินการนี้จะบอกให้ Renderdoc สามารถวางไฟล์บันทึก ซึ่งเข้าถึงได้ภายในแซนด์บ็อกซ์โปรแกรมจำลองหากคุณใช้แบ็กเอนด์ Vulkan เลือก การตั้งค่ากราฟิก > เลเยอร์โดยนัยของอินสแตนซ์ Vulkan และตรวจสอบว่า เลือก VKLAYER_RENDERDOC_Capture แล้ว
เปิดโปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC การวางซ้อน RenderDoc ถูกวาดที่ ที่ด้านบนตราบใดที่เปิดใช้การสนับสนุนอยู่
เปิด RenderDoc ได้ทุกเมื่อก่อนหรือหลังโปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC เปิดตัว
คลิกไฟล์ > แนบกับอินสแตนซ์ที่ทำงานอยู่ แล้วเลือก crosvm
ระบุตัวแปรสภาพแวดล้อม
คุณต้องเพิ่มหรือเปลี่ยนตัวแปรสภาพแวดล้อมเพื่อให้ Renderdoc ทำงานได้ ใน Windows คุณเปลี่ยนตัวแปรสภาพแวดล้อมได้โดยใช้ UI, PowerShell หรือ cmd.exe
ใช้ UI
- กด
Win+R เพื่อเปิดกล่องโต้ตอบการเรียกใช้ - พิมพ์
sysdm.cpl
เพื่อเปิดหน้าต่างคุณสมบัติของระบบ - เลือกแท็บขั้นสูง หากยังไม่ได้เปิดใช้งาน
- คลิกปุ่มตัวแปรสภาพแวดล้อม
จากที่นี่ คุณสามารถคลิกปุ่มใหม่เพื่อสร้างสภาพแวดล้อมใหม่ หรือเลือกตัวแปร แล้วคลิกปุ่มแก้ไขเพื่อแก้ไข
ใช้ PowerShell
ในหน้าต่าง PowerShell ให้พิมพ์:
$Env:VARIABLE_NAME=VALUE
แทนที่ VARIABLE_NAME
และ VALUE
ด้วยค่าที่ต้องการกำหนด สำหรับ
ตัวอย่างเช่น หากต้องการตั้งค่าประเภท ANDROID_EMU_RENDERDOC
เป็น "1"
ให้ทำดังนี้
$Env:ANDROID_EMU_RENDERDOC="1"
ใช้ cmd.exe
ในหน้าต่าง cmd.exe ให้พิมพ์:
set VARIABLE_NAME=VALUE
แทนที่ VARIABLE_NAME
และ VALUE
ด้วยค่าที่ต้องการกำหนด สำหรับ
ตัวอย่างเช่น หากต้องการตั้งค่าประเภท ANDROID_EMU_RENDERDOC
เป็น "1"
ให้ทำดังนี้
set ANDROID_EMU_RENDERDOC="1"
เคล็ดลับสำหรับ Android 11 (API ระดับ 30) ขึ้นไป
Google Play Games บน PC ได้รับการอัปเดตเป็น Android รุ่นล่าสุดแล้ว นี่คือ เคล็ดลับในการทำงานกับ Android เวอร์ชันล่าสุด
อัปเดตเครื่องมือให้เป็นปัจจุบันอยู่เสมอ
Android Studio จะติดตั้ง adb เวอร์ชันที่ทำงานร่วมกับนักพัฒนาแอปได้
emulator; แต่เครื่องมือเกมบางอย่างก็มี adb เวอร์ชันเก่าด้วย ในนั้น
หลังจากที่คุณติดตั้งโปรแกรมจำลองนักพัฒนาซอฟต์แวร์ คุณจะพบ
เวอร์ชันของ adb
ที่ C:\Program Files\Google\Play Games Developer
Emulator\current\emulator
หากคุณเปิดตัว adb
เวอร์ชันหนึ่ง ระบบจะยุติอีกเวอร์ชันหนึ่ง ซึ่งหมายความว่า
หากเกมเอนจินของคุณเปิดใช้อินสแตนซ์ adb
ของตัวเองโดยอัตโนมัติ
เพื่อเปิดอีกครั้งและเชื่อมต่อ adb
เวอร์ชันที่มากับนักพัฒนาแอปอีกครั้ง
โปรแกรมจำลองทุกครั้งที่คุณทำให้ใช้งานได้
หากใช้ Android App Bundle คุณต้องติดตั้งเวอร์ชันล่าสุดของ Bundletool จากที่เก็บของ GitHub
พื้นที่เก็บข้อมูลที่กำหนดขอบเขต
Android 11 (API ระดับ 30) ขึ้นไปมีพื้นที่เก็บข้อมูลที่กำหนดขอบเขต ซึ่ง การปกป้องแอปและข้อมูลผู้ใช้ในที่จัดเก็บข้อมูลภายนอกได้ดียิ่งขึ้น นอกจากการทำให้ เกมที่รองรับข้อกำหนดเกี่ยวกับพื้นที่เก็บข้อมูลที่กำหนดขอบเขต คุณจะต้องดำเนินการ ขั้นตอนเพิ่มเติมในการโหลดไฟล์สำหรับขยายของ APK (obb) หรือข้อมูลเนื้อหาลงใน โปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC ทำตามขั้นตอนต่อไปนี้หากพบปัญหา เข้าถึงไฟล์เหล่านั้นจากเกมของคุณ
- สร้างไดเรกทอรีที่แอปของคุณสามารถอ่านได้
- พุชไฟล์สำหรับขยายไปยังโปรแกรมจำลอง
adb shell mkdir /sdcard/Android/obb/com.example.game
adb push main.com.example.game.obb /sdcard/Android/obb/com.example.game
ระดับการเข้าถึงแพ็กเกจ
แอปที่กำหนดเป้าหมายเป็น Android 11 เนื่องด้วยกฎระดับการเข้าถึงแพ็กเกจใหม่
(API ระดับ 30) ขึ้นไปถูกบล็อกไม่ให้ค้นหาข้อมูลเกี่ยวกับฟังก์ชัน
แอปอื่นๆ ที่ติดตั้งในอุปกรณ์ ซึ่งหมายความว่าเกมถูกบล็อก
ไม่ให้เข้าถึงบริการ Google Play เมื่อไซด์โหลดผ่าน adb
แทนที่จะส่ง
ที่ติดตั้งผ่าน Play Store ในการทดสอบ IAP ด้วยเกมที่โหลดจากแหล่งที่ไม่รู้จัก
คุณต้องเพิ่มคำค้นหาไปยังแพ็กเกจ "com.android.vending
" ใน
AndroidManifest.xml
ดังต่อไปนี้
<manifest>
<queries>
<package android:name="com.android.vending" />
</queries>
</manifest>
การติดตั้งเกมในไคลเอ็นต์สำหรับผู้ใช้ทั่วไป
คุณไม่สามารถติดตั้งเกมในไคลเอ็นต์ของผู้บริโภค จนกว่าเกมจะแสดงใน แคตตาล็อกบริการเกมของ Play หลังจากที่เกมเปิดตัวซิงเกิล สร้างแทร็กทดสอบภายในเพื่อตรวจสอบการอัปเดตในอนาคตได้ ก่อนเปิดตัว
ไคลเอ็นต์โปรแกรมเล่นไม่รองรับคุณลักษณะที่นักพัฒนาซอฟต์แวร์มุ่งเน้น โปรแกรมจําลองสําหรับนักพัฒนาแอป Google Play Games บน PC เหมาะสำหรับ QA เกมก่อนเปิดตัว เพื่อทดสอบประสบการณ์ของโปรแกรมเล่นตั้งแต่ต้นจนจบหลังจากการเปิดตัวครั้งแรก