เอกสารนี้อธิบายวิธีผสานรวม Android Performance Tuner หรือที่เรียกว่าไลบรารี Tuning Fork เพื่อบันทึกและอัปโหลดข้อมูลเวลาที่ใช้ในการแสดงผลเฟรมจากเกมเอนจินแบบเนทีฟ (C และ C++)
สำหรับเกมเอนจิน Unity โปรดดูคู่มือสำหรับ Unity
ฉากหลัง
องค์ประกอบสำคัญของประสบการณ์การเล่นเกมคือประสิทธิภาพการแสดงผล ประสิทธิภาพการแสดงผลเป็นผลลัพธ์ของอินพุต 2 รายการต่อไปนี้
- อัตราเฟรม: ความถี่ในการวาดเฟรม
- การตั้งค่าคุณภาพกราฟิก: ระดับความสมจริงของเฟรมที่แสดง รวมถึงความสมจริงของการจำลองและกราฟิก
สำหรับเกม ประสิทธิภาพการแสดงผลที่ดีจะกำหนดไว้ดังนี้
- การแสดงอัตราเฟรมที่คงที่และสม่ำเสมอ (นั่นคือเปอร์เซ็นต์ของเฟรมที่แสดงผลตามความถี่ที่ต้องการ)
- แสดงผลเฟรมที่ความถี่สูงสุดเท่าที่เป็นไปได้โดยยังคงรักษาความเสถียรไว้ ซึ่งโดยปกติจะอยู่ที่ 30 หรือ 60 FPS ขึ้นอยู่กับประเภทของเกม
- เพิ่มระดับรายละเอียดให้มากที่สุดสำหรับผู้ใช้ตามขนาดและความหนาแน่นของหน้าจอ โดยที่ยังคงได้อัตราเฟรมที่เสถียรตามที่ต้องการ
ไลบรารีการเว้นระยะเฟรมของ Android จะจำกัดความแปรปรวนของเวลาที่ใช้ในการแสดงผลเฟรมเป็นส่วนใหญ่ เพื่อให้อัตราเฟรมคงที่สำหรับเกม ความแปรปรวนที่เหลืออยู่ในเวลาที่ใช้ในการแสดงผลเฟรมเกิดจากระดับรายละเอียดที่แสดงในบางฉากระหว่างเกมเพลย์และความสามารถด้านกราฟิกของอุปกรณ์ เมื่อใช้ Android Performance Tuner คุณจะระบุเวลาในระหว่างการเล่นเกมที่เวลาที่ใช้ในการแสดงผลเฟรมช้าหรือเร็วกว่าเป้าหมายได้ และเชื่อมโยงปัญหาและโอกาสเหล่านี้กับสิ่งต่อไปนี้
- การตั้งค่าคุณภาพที่เฉพาะเจาะจง
- ฉากที่เฉพาะเจาะจงในเกม
- รุ่นอุปกรณ์หรือสเปกอุปกรณ์ที่เฉพาะเจาะจง
บันทึกและอัปโหลดข้อมูล
ไลบรารี Tuning Fork อาศัยฟังก์ชัน Tick รายการใดรายการหนึ่งที่ไลบรารี Android Frame Pacing เรียกใช้ในแต่ละเฟรม ภายในไลบรารี ข้อมูลการทำงานนี้จะรวบรวมไว้ในฮิสโตแกรมซึ่งจะอัปโหลดไปยัง Google Play เป็นระยะๆ ผ่านปลายทาง HTTP ระบบจะบันทึกแต่ละ Tick ว่าเชื่อมโยงกับคีย์ระบุตำแหน่งของ Tick และคำอธิบายประกอบ ซึ่งคุณระบุคำจำกัดความไว้ในไฟล์บัฟเฟอร์โปรโตคอล
คีย์ระบุตำแหน่งของ Tick
คีย์ระบุตำแหน่งของ Tick จะระบุตำแหน่งในเฟรมที่ Tick มาจากและเป็นจำนวนเต็มที่ต้องส่งไปยังการเรียกใช้ฟังก์ชัน Tick แต่ละครั้ง ไลบรารี Android Frame Pacing ใช้ชุดคีย์ระบุตำแหน่งของ Tick ที่กำหนดไว้ล่วงหน้าใน swappy_common.h
นอกจากนี้ คุณยังกำหนดคีย์ระบุตำแหน่งของ Tick ของคุณเองได้หากไม่ได้ใช้ไลบรารี Frame Pacing
คำอธิบายประกอบ
คำอธิบายประกอบจะให้ข้อมูลตามบริบทเกี่ยวกับสิ่งที่เกมกำลังทำเมื่อมีการบันทึกขีด ตัวอย่างเช่น คำอธิบายประกอบอาจระบุสิ่งต่อไปนี้
- ระดับเกมปัจจุบัน
- "บอสใหญ่" อยู่บนหน้าจอ
- ข้อมูลสถานะเกมอื่นๆ ที่เกี่ยวข้อง
คำอธิบายประกอบกำหนดโดยข้อความบัฟเฟอร์โปรโตคอล com.google.tuningfork.Annotation หากต้องการตั้งค่าคำอธิบายประกอบปัจจุบัน คุณต้องส่งการเรียงลำดับข้อความที่กำหนดไปยัง TuningFork_setCurrentAnnotation จากนั้นข้อมูลขีดทั้งหมดที่ตามมาจะเชื่อมโยงกับคำอธิบายประกอบนี้จนกว่าจะมีการตั้งค่าคำอธิบายประกอบอื่น ต่อไปนี้เป็นตัวอย่างคำจำกัดความของโปรโตสำหรับคำอธิบายประกอบ
import "tuningfork.proto"
enum Level {
INVALID_LEVEL = 0;
Level_1 = 1;
Level_2 = 2;
Level_3 = 3;
}
message Annotation {
optional Level level = 1;
}
พารามิเตอร์ความแม่นยำ
พารามิเตอร์ความแม่นยำจะส่งผลต่อประสิทธิภาพและความคมชัดของกราฟิกในเกม เช่น ระดับรายละเอียดของ Mesh, ความละเอียดของพื้นผิว และวิธีการลดรอยหยัก พารามิเตอร์ความแม่นยำจะกำหนดโดยใช้ข้อความบัฟเฟอร์โปรโตคอล com.google.tuningfork.FidelityParams เช่นเดียวกับคำอธิบายประกอบ ต่อไปนี้เป็นตัวอย่างคำจำกัดความของโปรโตสำหรับพารามิเตอร์ความแม่นยำ
import "tuningfork.proto"
message FidelityParams {
int32 texture_quality_level = 1;
int32 shadow_resolution = 2;
float terrain_details_percent = 3;
int32 post_processing_effects_level = 4;
}
เมื่อเริ่มต้น Tuning Fork คุณจะส่งการเรียงอันดับพารามิเตอร์ที่เกมใช้ คุณสามารถเปลี่ยนพารามิเตอร์เหล่านี้ได้ เช่น หากผู้ใช้เปลี่ยนการตั้งค่าการแสดงผลเกม และข้อมูลที่อัปโหลดในภายหลังเชื่อมโยงกับพารามิเตอร์ใหม่
เพื่อให้ Google Play เข้าใจคำอธิบายประกอบและพารามิเตอร์ความแม่นยำที่คุณกำหนด ไฟล์บัฟเฟอร์โปรโตคอลที่มีคำจำกัดความเหล่านี้ต้องรวมอยู่ใน APK ของเกมพร้อมกับการตั้งค่าการเริ่มต้น นอกจากนี้ คุณยังต้องระบุค่าเริ่มต้นสำหรับชุดค่าผสมของพารามิเตอร์ความแม่นยำทั่วไปใน APK เพื่อให้ระบบแบ่งกลุ่มข้อมูลตามชุดค่าผสมเหล่านั้นใน UI ของ Google Play ดูข้อมูลเพิ่มเติมได้ที่กำหนดระดับคุณภาพ
โอเวอร์เฮดของหน่วยความจำและ CPU
หน่วยความจำทั้งหมดที่ไลบรารี Tuning Fork ใช้จะได้รับการจัดสรรเมื่อเริ่มต้นเพื่อหลีกเลี่ยงปัญหาที่ไม่คาดคิดระหว่างการเล่นเกม ขนาดของข้อมูลจะขึ้นอยู่กับจำนวนคีย์ระบุตำแหน่งของ Tick, จำนวนคำอธิบายประกอบที่เป็นไปได้ และจำนวนที่เก็บข้อมูลในฮิสโตแกรมแต่ละรายการ โดยเป็นผลคูณของค่าทั้งหมดนี้คูณด้วย 4 ไบต์สำหรับที่เก็บข้อมูลแต่ละรายการ นอกจากนี้ยังมีสำเนาฮิสโตแกรมทั้งหมด 2 ชุดเพื่อให้ส่งในรูปแบบบัฟเฟอร์คู่ได้
การส่งจะเกิดขึ้นในชุดข้อความแยกต่างหากและไม่บล็อกการเรียกใช้ Tick หากไม่มีการเชื่อมต่อเพื่ออัปโหลด ระบบจะจัดคิวการส่งไว้เพื่ออัปโหลดในภายหลัง
การเรียกใช้ฟังก์ชัน Tick มีค่าใช้จ่ายในการประมวลผลเพียงเล็กน้อย โดยจะคำนวณดัชนีในอาร์เรย์ของที่เก็บฮิสโตแกรมและเพิ่มจำนวนจำนวนเต็ม
ผสานรวมไลบรารี Tuning Fork
คู่มือการผสานรวมนี้แบ่งออกเป็น 2 ส่วน ส่วนแรกจะอธิบายวิธีทำการทดสอบตั้งแต่ต้นจนจบโดยใช้แอปสาธิตและ Google Play Console ส่วนที่ 2 อธิบายวิธีผสานรวมไลบรารี Tuning Fork เข้ากับ Toolchain และวิธีใช้ฟังก์ชันที่ไลบรารีมีให้ คลิกลิงก์ถัดไปด้านล่างเพื่อเริ่มต้นใช้งาน