ภาพรวมของ Android Performance Tuner (เนทีฟ)

เอกสารนี้อธิบายวิธีผสานรวม 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 และวิธีใช้ฟังก์ชันที่ไลบรารีมีให้ คลิกลิงก์ถัดไปด้านล่างเพื่อเริ่มต้นใช้งาน