Overview
เมื่อไหร่ที่ต้องใช้
หาก Primuse แครช หยุดตอบสนอง ข้ามเพลงระหว่างสแกน เชื่อมต่อแหล่งเพลงไม่ได้ หรือการเล่นสะดุด นักพัฒนามักต้องการบันทึกของช่วงเวลาที่เกิดปัญหา ข้อมูลการวินิจฉัยจะอยู่บนอุปกรณ์ของคุณและไม่ถูกส่งโดยอัตโนมัติ จะออกจากอุปกรณ์ก็ต่อเมื่อคุณส่งเองเท่านั้น
ก่อนเริ่ม
- ตรวจสอบเวอร์ชันแอป: ใน การตั้งค่า → เกี่ยวกับ จะแสดง เวอร์ชัน และ สร้าง โปรดระบุไว้ในรายงานของคุณ
- การอัปโหลดต้องใช้อินเทอร์เน็ต อุปกรณ์แต่ละเครื่องอัปโหลดได้สูงสุด 5 ครั้งต่อวัน และแต่ละแพ็กเกจต้องไม่เกิน 8 MB
ขั้นที่ 1: เปิดโหมดวินิจฉัย (แนะนำ)
- เปิด การตั้งค่า → เกี่ยวกับ → “รายงานการวินิจฉัย”
- Mac: การตั้งค่า → เกี่ยวกับ → “บันทึกการวินิจฉัย...” แล้วคลิก “รายงานการวินิจฉัย” ในหน้าต่างที่เปิดขึ้น
- Apple TV: เปิด “รายงานการวินิจฉัย” ใน การตั้งค่า
- เปิด “เก็บบันทึกแบบละเอียด” ในอีก 24 ชั่วโมงถัดไปแอปจะบันทึกรายละเอียดเพิ่มเติมสำหรับแก้ไขปัญหา แล้วปิดตัวเลือกนี้เอง
- ทำให้ปัญหาเกิดซ้ำ (เช่น สแกนอีกครั้ง เล่นเพลงอีกครั้ง หรือเชื่อมต่อแหล่งเพลงใหม่) และจดเวลาโดยประมาณไว้
สิ่งที่เกิดขึ้นก่อนเปิดโหมดจะอยู่ในบันทึกพื้นฐานเท่านั้นและอาจไม่ละเอียดพอ จึงควรทำให้ปัญหาเกิดซ้ำหนึ่งครั้งขณะเปิดโหมดอยู่
ขั้นที่ 2: อัปโหลดให้นักพัฒนา
- ในหน้า “รายงานการวินิจฉัย” แตะ “ส่งถึงผู้พัฒนา” ในแถบเครื่องมือ
- ใน “ไฟล์แนบ (ไม่บังคับ)” เลือกสิ่งที่จะแนบ: “รายงานการวินิจฉัย” (รายงานการแครชและการค้าง ข้อมูลประสิทธิภาพ) และ “บันทึก”
- หากต้องการ ให้เพิ่มภาพหน้าจอใน “รูปภาพ (ไม่บังคับ)” (สูงสุด 6 ภาพ ย่อขนาดอัตโนมัติ) และอธิบายใน “คำขอหรือข้อเสนอแนะ” ว่าคุณกำลังทำอะไร คาดหวังอะไร เกิดอะไรขึ้นจริง และประมาณเวลาใด
- แตะ “อัปโหลดถึงผู้พัฒนา” ด้านล่าง จะแสดง “กำลังรวบรวม…”, “กำลังอัปโหลด …%” และ “กำลังยืนยัน…” ตามลำดับ
- เมื่อแสดง “อัปโหลดถึงผู้พัฒนาแล้ว” ให้แตะ “คัดลอกรหัส” แล้วระบุรหัสในรายงานบน GitHub หรือในอีเมล
ผลลัพธ์ที่คาดหวัง: หน้าจอแสดงรหัสรายงาน หลังอัปโหลดสำเร็จ รายงานและบันทึกที่อัปโหลดแล้วจะถูกลบออกจากอุปกรณ์
Apple TV ไม่มีรายงานการแครชจากระบบ จึงอัปโหลดได้เฉพาะบันทึกและข้อความของคุณ หลังแสดงรหัสแล้วสามารถแตะ “ส่งอีกชุด” เพื่อส่งเพิ่มได้
หากอัปโหลดไม่ได้: อีเมลหรือการแชร์
- ใต้ปุ่มอัปโหลดมี “ส่งทางอีเมลแทน” หรือ “แชร์ด้วยวิธีอื่นแทน” รายงานหรือบันทึกที่เลือกจะถูกแนบไปกับข้อความ และคุณตรวจดูได้ก่อนส่ง
- หากบริการอัปโหลดไม่พร้อมใช้งาน ปุ่มอัปโหลดจะไม่แสดง แถบเครื่องมือจะแสดง “เปิดเมล” หรือ “แชร์” พร้อมที่อยู่อีเมลของนักพัฒนา
- เวอร์ชันก่อน 1.12.2 ไม่มีการอัปโหลด ให้ใช้ “ส่งถึงผู้พัฒนา” เพื่อส่งทางอีเมลหรือการแชร์
แชร์รายงานฉบับเดียว
แตะรายงานในหน้า “รายงานการวินิจฉัย” เพื่อแชร์เฉพาะฉบับนั้น บน Mac ปุ่ม “ส่งออกบันทึก” จะแสดงไฟล์บันทึกใน Finder
ความหมายของตัวเลือก
| ตัวเลือก | ความหมาย |
|---|---|
| รายงานการขัดข้องและค้าง | รายงานที่ระบบทิ้งไว้หลังแอปแครชหรือค้างนาน มักปรากฏหลังเปิดแอปอีกครั้ง |
| ตัวชี้วัดการทำงาน | ข้อมูลประสิทธิภาพที่ระบบให้เป็นระยะ เช่น การใช้หน่วยความจำสูงสุดและสาเหตุที่แอปถูกปิด |
| บันทึก | บันทึกของแอปเองเกี่ยวกับการเล่น การสแกน และการซิงค์ล่าสุด เมื่ออัปโหลดหรือแชร์จะรวมเฉพาะส่วนล่าสุด |
| เก็บบันทึกแบบละเอียด | บันทึกรายละเอียดเพิ่มขึ้นเป็นเวลา 24 ชั่วโมงแล้วปิดเอง |
| ล้างบันทึก | ลบบันทึกบนอุปกรณ์นี้ ย้อนกลับไม่ได้ |
ความเป็นส่วนตัว
บันทึกมีชื่อเพลงและเส้นทางไฟล์ ส่วนที่อยู่และบัญชีของแหล่งเพลงจะถูกแทนด้วยป้ายสั้น ๆ รหัสผ่าน โทเค็น และข้อมูลรับรองอื่น ๆ จะถูกลบออกก่อนบันทึก ข้อมูลที่อัปโหลดใช้เพื่อแก้ไขปัญหาเท่านั้น และจะถูกลบออกจากเซิร์ฟเวอร์ของนักพัฒนาหลัง 30 วัน (หรือเร็วกว่านั้นหากพื้นที่ไม่พอ) ก่อนส่งคุณสามารถยกเลิกการเลือก “บันทึก” หรือไม่แนบภาพหน้าจอได้
ข้อจำกัด
- การอัปโหลดแต่ละครั้งไม่เกิน 8 MB หลังแพ็กเกจ อุปกรณ์ละ 5 ครั้งต่อวัน และนับรวมความพยายามที่ไม่สำเร็จด้วย
- รายงานและบันทึกเก็บไว้บนอุปกรณ์ประมาณ 7 วัน
- Apple TV ไม่มีรายงานการแครชและการค้าง Apple Watch ไม่มีหน้าวินิจฉัย ให้รายงานจาก iPhone ที่จับคู่ไว้