เมื่อกำหนดรูปแบบที่ ExoPlayer รองรับ โปรดทราบว่า "รูปแบบสื่อ" กำหนดไว้ในหลายระดับ จากระดับต่ำสุดไปยัง สูงสุด ซึ่งได้แก่
- รูปแบบของตัวอย่างสื่อแต่ละรายการ (เช่น เฟรมของวิดีโอหรือเฟรม ของรูปแบบเสียง) นี่เป็นรูปแบบตัวอย่าง โปรดทราบว่าไฟล์วิดีโอทั่วไปจะ มีสื่อในรูปแบบตัวอย่างอย่างน้อย 2 รูปแบบ ตัวเลือกหนึ่งสำหรับวิดีโอ (เช่น H.264) และ 1 ตัวสำหรับเสียง (เช่น AAC)
- รูปแบบของคอนเทนเนอร์ที่เก็บตัวอย่างสื่อและเชื่อมโยง ข้อมูลเมตา นี่คือรูปแบบคอนเทนเนอร์ ไฟล์สื่อมีคอนเทนเนอร์เดียว (เช่น MP4) ซึ่งโดยทั่วไปจะระบุด้วยนามสกุลไฟล์ หมายเหตุ สำหรับรูปแบบเสียงอย่างเดียวบางรูปแบบ (เช่น MP3) ตัวอย่างและรูปแบบที่เก็บ อาจเหมือนกันก็ได้
- เทคโนโลยีสตรีมมิงแบบปรับอัตโนมัติ เช่น DASH, SmoothStreaming และ HLS เหล่านี้ ไม่ใช่รูปแบบสื่อ แต่ยังจำเป็นต้องกำหนดสิ่งที่ ที่ ExoPlayer มอบให้
ส่วนต่อไปนี้จะอธิบายการรองรับ ExoPlayer ในแต่ละระดับ ตั้งแต่สูงสุดไปจนถึง ที่ต่ำที่สุด 2 ส่วนสุดท้ายอธิบายการรองรับรูปแบบคำบรรยายแบบสแตนด์อโลน และการเล่นวิดีโอ HDR
การสตรีมแบบปรับอัตโนมัติ
แดชบอร์ด
ExoPlayer รองรับ DASH ด้วยรูปแบบคอนเทนเนอร์หลายรูปแบบ สตรีมสื่อต้องเป็น
demuxed ซึ่งหมายความว่าวิดีโอ เสียง และข้อความต้องได้รับการกำหนดแยกกัน
องค์ประกอบ AdaptationSet ในไฟล์ Manifest ของ DASH (CEA-608 เป็นข้อยกเว้นเช่นเดียวกับ
ดังที่อธิบายไว้ในตารางด้านล่าง) รูปแบบเสียงและวิดีโอตัวอย่างที่มีอยู่ต้อง
(โปรดดู
รูปแบบตัวอย่างเพื่อดูรายละเอียด)
| ฟีเจอร์ | รองรับ | ความคิดเห็น |
|---|---|---|
| คอนเทนเนอร์ | ||
| FMP4 | ใช่ | สตรีมที่ถอดรหัสเท่านั้น |
| WebM | ใช่ | สตรีมที่ถอดรหัสเท่านั้น |
| มาโทรสกา | ใช่ | สตรีมที่ถอดรหัสเท่านั้น |
| MPEG-TS | ไม่ | ไม่ได้วางแผนการสนับสนุน |
| คำบรรยายแทนเสียง/คำบรรยาย | ||
| TTML | ใช่ | ไฟล์ข้อมูล RAW หรือฝังอยู่ใน FMP4 ตามมาตรฐาน ISO/IEC 14496-30 |
| WebVTT | ใช่ | ไฟล์ข้อมูล RAW หรือฝังอยู่ใน FMP4 ตามมาตรฐาน ISO/IEC 14496-30 |
| CEA-608 | ใช่ | ฝังอยู่ใน FMP4 เมื่อมีสัญญาณโดยใช้ข้อบ่งชี้การช่วยเหลือพิเศษ SCTE |
| CEA-708 | ใช่ | ฝังอยู่ใน FMP4 เมื่อมีสัญญาณโดยใช้ข้อบ่งชี้การช่วยเหลือพิเศษ SCTE |
| ข้อมูลเมตา | ||
| ข้อมูลเมตา EMSG | ใช่ | ฝังอยู่ใน FMP4 |
| การปกป้องเนื้อหา | ||
| Widevine | ใช่ | "cenc" สคีม: API 19+; "ลูกบาศก์" สคีม: API 25+ |
| PlayReady SL2000 | ใช่ | Android TV, "cenc" สคีมเท่านั้น |
| คีย์เคลียร์คีย์ | ใช่ | API 21 ขึ้นไป, "cenc" สคีมเท่านั้น |
| การเล่นแบบสด | ||
| การเล่นแบบสดปกติ | ใช่ | |
| การเล่นแบบสดของ CMAF ที่มีเวลาในการตอบสนองต่ำมาก | ใช่ | |
| ข้อมูลไคลเอ็นต์สื่อทั่วไป (CMCD) | ใช่ | คู่มือการผสานรวม |
สตรีมมิงแบบราบรื่น
ExoPlayer รองรับ SmoothStreaming ในรูปแบบคอนเทนเนอร์ FMP4 สตรีมสื่อ ต้องถูกแยกออกจากกัน ซึ่งหมายความว่าวิดีโอ เสียง และข้อความต้องได้รับการกำหนดแยกกัน องค์ประกอบ StreamIndex ในไฟล์ Manifest SmoothStreaming เสียงที่มีการควบคุมและ รูปแบบวิดีโอตัวอย่างยังต้องได้รับการสนับสนุน (ดู รูปแบบตัวอย่างเพื่อดูรายละเอียด)
| ฟีเจอร์ | รองรับ | ความคิดเห็น |
|---|---|---|
| คอนเทนเนอร์ | ||
| FMP4 | ใช่ | สตรีมที่ถอดรหัสเท่านั้น |
| คำบรรยายแทนเสียง/คำบรรยาย | ||
| TTML | ใช่ | ฝังอยู่ใน FMP4 |
| การปกป้องเนื้อหา | ||
| PlayReady SL2000 | ใช่ | Android TV เท่านั้น |
| การเล่นแบบสด | ||
| การเล่นแบบสดปกติ | ใช่ | |
| ข้อมูลไคลเอ็นต์สื่อทั่วไป (CMCD) | ใช่ | คู่มือการผสานรวม |
HLS
ExoPlayer รองรับ HLS ที่มีรูปแบบคอนเทนเนอร์หลายรูปแบบ เสียงที่มีการควบคุมและ รูปแบบวิดีโอตัวอย่างต้องได้รับการสนับสนุนด้วย (ดู รูปแบบตัวอย่างเพื่อดูรายละเอียด) พ ขอแนะนำอย่างยิ่งให้ผู้ผลิตเนื้อหา HLS สร้างสตรีม HLS คุณภาพสูง ตามที่อธิบายไว้ ที่นี่
| ฟีเจอร์ | รองรับ | ความคิดเห็น |
|---|---|---|
| คอนเทนเนอร์ | ||
| MPEG-TS | ใช่ | |
| FMP4/CMAF | ใช่ | |
| ADTS (AAC) | ใช่ | |
| MP3 | ใช่ | |
| คำบรรยายแทนเสียง/คำบรรยาย | ||
| CEA-608 | ใช่ | |
| CEA-708 | ใช่ | |
| WebVTT | ใช่ | |
| ข้อมูลเมตา | ||
| รหัส 3 | ใช่ | |
| SCTE-35 | ไม่ | |
| การปกป้องเนื้อหา | ||
| แบบ AES-128 | ใช่ | |
| ตัวอย่าง AES-128 | ไม่ | |
| Widevine | ใช่ | API 19+ (ชุดรูปแบบ "cenc") และ 25+ (ชุดรูปแบบ "cbcs") |
| PlayReady SL2000 | ใช่ | Android TV เท่านั้น |
| การควบคุมเซิร์ฟเวอร์ | ||
| การอัปเดตเดลต้า | ใช่ | |
| กำลังบล็อกการโหลดเพลย์ลิสต์ซ้ำ | ใช่ | |
| บล็อกการโหลดคำแนะนำการโหลดล่วงหน้า | ใช่ | ยกเว้นไบต์เรนจ์ที่มีความยาวที่ระบุไม่ได้ |
| การเล่นแบบสด | ||
| การเล่นแบบสดปกติ | ใช่ | |
| HLS เวลาในการตอบสนองต่ำ (Apple) | ใช่ | |
| HLS เวลาในการตอบสนองต่ำ (ชุมชน) | ไม่ | |
| ข้อมูลไคลเอ็นต์สื่อทั่วไป (CMCD) | ใช่ | คู่มือการผสานรวม |
รูปแบบคอนเทนเนอร์แบบโปรเกรสซีฟ
ExoPlayer จะเล่นสตรีมในรูปแบบคอนเทนเนอร์ต่อไปนี้ได้โดยตรง นอกจากนี้ยังต้องรองรับรูปแบบเสียงและวิดีโอตัวอย่างที่มีอยู่ด้วย (ดู ส่วนรูปแบบตัวอย่างเพื่อดูรายละเอียด) สำหรับการรองรับคอนเทนเนอร์รูปภาพและรูปแบบ โปรดดูที่ รูปภาพ
| รูปแบบคอนเทนเนอร์ | รองรับ | ความคิดเห็น |
|---|---|---|
| MP4 | ใช่ | |
| M4A | ใช่ | |
| FMP4 | ใช่ | |
| WebM | ใช่ | |
| มาโทรสกา | ใช่ | |
| MP3 | ใช่ | สตรีมบางสตรีมค้นหาได้โดยใช้อัตราบิตคงที่เท่านั้น** |
| Ogg | ใช่ | มี Vorbis, Opus และ FLAC |
| WAV | ใช่ | |
| MPEG-TS | ใช่ | |
| MPEG-PS | ใช่ | |
| FLV | ใช่ | ไม่สามารถค้นหาได้* |
| ADTS (AAC) | ใช่ | สามารถค้นหาได้โดยใช้การกรอวิดีโอด้วยอัตราบิตคงที่เท่านั้น** |
| FLAC | ใช่ | การใช้ไลบรารี FLAC หรือเครื่องมือแยก FLAC ในไลบรารี ExoPlayer*** |
| AMR | ใช่ | สามารถค้นหาได้โดยใช้อัตราบิตคงที่เท่านั้น** |
* ไม่รองรับการกรอเนื่องจากคอนเทนเนอร์ไม่มีข้อมูลเมตา (เช่น ดัชนีตัวอย่าง) เพื่อช่วยให้มีเดียเพลเยอร์ค้นหาด้วยวิธีที่มีประสิทธิภาพ หากจำเป็นต้องกรอวิดีโอ เราขอแนะนำให้ใช้รูปแบบคอนเทนเนอร์ที่เหมาะสมกว่า
** เครื่องมือแยกข้อมูลเหล่านี้มี FLAG_ENABLE_CONSTANT_BITRATE_SEEKING Flag สำหรับ
เปิดใช้งานการกรอวิดีโอโดยประมาณโดยใช้สมมติฐานเกี่ยวกับอัตราบิตคงที่ ช่วงเวลานี้
ฟังก์ชันการทำงานไม่ได้เปิดใช้งานโดยค่าเริ่มต้น วิธีที่ง่ายที่สุดในการดำเนินการนี้
ฟังก์ชันการทำงานของเครื่องมือแยกทุกส่วนที่รองรับการใช้งาน
DefaultExtractorsFactory.setConstantBitrateSeekingEnabled ตามที่อธิบายไว้
ที่นี่
*** เครื่องมือแยกไลบรารี FLAC จะส่งออกเสียงดิบที่สามารถจัดการได้
ตามเฟรมเวิร์กในทุกระดับของ API เอาต์พุตจากตัวแยก FLAC ของไลบรารี ExoPlayer
เฟรมเสียง FLAC จึงต้องอาศัยตัวถอดรหัส FLAC (ตัวอย่างเช่น MediaCodec
ที่ใช้แทน FLAC (จำเป็นจาก API ระดับ 27) หรือ
ไลบรารี FFmpeg ที่เปิดใช้ FLAC) DefaultExtractorsFactory ใช้
เครื่องมือแยกส่วนขยายหากแอปพลิเคชันสร้างขึ้นด้วยไลบรารี FLAC
มิเช่นนั้น จะใช้เครื่องมือแยกไลบรารี ExoPlayer
RTSP
ExoPlayer รองรับ RTSP ทั้งแบบสดและออนดีมานด์ รูปแบบตัวอย่างที่รองรับและ ประเภทเครือข่ายมีดังต่อไปนี้
รูปแบบตัวอย่างที่รองรับ
- H264 (คำอธิบายสื่อ SDP ต้องมีข้อมูล SPS/PPS ใน fmtp สำหรับการเริ่มต้นตัวถอดรหัส)
- AAC (ที่มีบิตสตรีม ADTS)
- AC3
ประเภทเครือข่ายที่รองรับ
- RTP ผ่าน UDP แบบ Unicast (ไม่รองรับมัลติแคสต์)
- RTSP แบบแทรกสลับ, RTP ผ่าน RTSP โดยใช้ TCP
รูปแบบตัวอย่าง
โดยค่าเริ่มต้น ExoPlayer จะใช้ตัวถอดรหัสแพลตฟอร์มของ Android ดังนั้น ฟังก์ชัน รูปแบบตัวอย่างจะขึ้นอยู่กับแพลตฟอร์มพื้นฐาน มากกว่า ExoPlayer โปรดดูที่รูปแบบสื่อที่รองรับสำหรับ เอกสารเกี่ยวกับรูปแบบตัวอย่างที่อุปกรณ์ Android รองรับ โปรดทราบว่า อุปกรณ์แต่ละเครื่องอาจรองรับรูปแบบอื่นๆ นอกเหนือจากที่แสดงไว้ด้วย
นอกจากตัวถอดรหัสแพลตฟอร์มของ Android แล้ว ExoPlayer ยังสามารถใช้ประโยชน์จาก ส่วนขยายตัวถอดรหัสซอฟต์แวร์ รหัสผ่านเหล่านี้ต้องสร้างขึ้นเองและรวมไว้ใน ที่ต้องการใช้ ตอนนี้เรามีเครื่องมือถอดรหัสซอฟต์แวร์ ห้องสมุดสำหรับ AV1 VP9 FLAC Opus และ FFmpeg
ไลบรารี FFmpeg
ไลบรารี FFmpeg รองรับ การถอดรหัสเสียงตัวอย่างรูปแบบต่างๆ คุณเลือกได้ว่า ตัวถอดรหัสที่รวมไว้เมื่อสร้างไลบรารีตามที่กำหนดไว้ใน README.md ของห้องสมุด ตารางต่อไปนี้จะแสดงการแมปจากรูปแบบเสียงตัวอย่างไปยัง ชื่อตัวถอดรหัส FFmpeg
| ตัวอย่างรูปแบบ | ชื่อตัวถอดรหัส |
|---|---|
| Vorbis | Vorbis |
| Opus | โอปัส |
| FLAC | flac |
| ALAC | Alac |
| PCM μ-law | PCM Mulaw |
| กฎหมาย PCM | Pcm_alaw |
| MP1, MP2, MP3 | mp3 |
| AMR-NB | Amrnb |
| AMR-WB | Amrwb |
| AAC | AAC |
| AC-3 | AC3 |
| แบบ E-AC-3 | EAC3 |
| DTS, DTS-HD | DCa |
| TrueHD | MLP Truehd |
รูปภาพ
ExoPlayer รองรับรูปแบบรูปภาพต่อไปนี้ โปรดดู ไลบรารีการโหลดรูปภาพ เกี่ยวกับวิธีผสานรวมกับไลบรารีภายนอกที่อาจให้การสนับสนุน รูปแบบต่างๆ กัน
| รูปแบบรูปภาพ | รองรับ | หมายเหตุ |
|---|---|---|
| BMP | ใช่ | |
| GIF | ไม่ | ไม่รองรับตัวแยก |
| JPEG | ใช่ | |
| รูปภาพเคลื่อนไหว JPEG | ใช่ | รองรับภาพนิ่งและวิดีโอ |
| JPEG Ultra HDR | ใช่ | กลับไปใช้ SDR ก่อน Android 14 หรือเวอร์ชันที่ใหม่กว่า จอแสดงผลที่ไม่ใช่ HDR |
| PNG | ใช่ | |
| WebP | ใช่ | |
| HEIF/HEIC | ใช่ | |
| รูปภาพเคลื่อนไหว HEIC | เพียงบางส่วน | รองรับเฉพาะภาพนิ่งเท่านั้น* |
| AVIF (เกณฑ์พื้นฐาน) | ใช่ | ถอดรหัสใน Android 14 ขึ้นไปเท่านั้น |
* ส่วนวิดีโอของภาพเคลื่อนไหว HEIC จะรับได้ด้วย MetadataRetriever และเล่นเป็นไฟล์แบบสแตนด์อโลน
รูปแบบคำบรรยายแบบสแตนด์อโลน
ExoPlayer รองรับไฟล์คำบรรยายแบบสแตนด์อโลนในรูปแบบต่างๆ ชื่อรอง จะโหลดจากจากแหล่งที่ไม่รู้จักได้ตามที่อธิบายไว้ในหน้ารายการสื่อ
| รูปแบบคอนเทนเนอร์ | รองรับ | ประเภท MIME |
|---|---|---|
| WebVTT | ใช่ | MimeTypes.TEXT_VTT |
| TTML / SMPTE-TT | ใช่ | MimeTypes.APPLICATION_TTML |
| SubRip | ใช่ | MimeTypesAPPLICATION_SUBRIP |
| SubStationAlpha (SSA/ASS) | ใช่ | ประเภท Mime TEXT_SSA |
การเล่นวิดีโอ HDR
ExoPlayer จะจัดการกับการแยกวิดีโอ High Dynamic Range (HDR) ในหลายๆ ด้าน ซึ่งรวมถึง Dolby Vision ใน MP4 และ HDR10+ ใน Matroska/WebM กำลังถอดรหัส การแสดงเนื้อหา HDR ขึ้นอยู่กับการสนับสนุนจากแพลตฟอร์ม Android และ อุปกรณ์ โปรดดู การเล่นวิดีโอ HDR เพื่อดูข้อมูลเกี่ยวกับการตรวจสอบความสามารถในการถอดรหัส/การแสดงผล HDR และข้อจำกัดของ รองรับ HDR ใน Android ทุกเวอร์ชัน
เมื่อเปิดสตรีม HDR ที่ต้องมีการรองรับโปรไฟล์ตัวแปลงรหัสที่เฉพาะเจาะจง
ตัวเลือก MediaCodec เริ่มต้นของ ExoPlayer จะเลือกตัวถอดรหัสที่รองรับ
(หากมี) แม้ว่าจะมีการใช้ตัวถอดรหัสอื่นสำหรับ MIME ประเภทเดียวกันที่
ไม่สนับสนุนโปรไฟล์นั้นจะปรากฏขึ้นในลำดับที่สูงกว่าในรายการตัวแปลงรหัส ซึ่งอาจส่งผลให้
ในการเลือกตัวถอดรหัสซอฟต์แวร์ในกรณีที่สตรีมเกิน
ความสามารถของตัวถอดรหัสฮาร์ดแวร์สำหรับ MIME ประเภทเดียวกัน