ExoPlayer รองรับ RTSP ทั้งแบบสดและแบบออนดีมานด์ รูปแบบตัวอย่างและประเภทเครือข่ายที่รองรับมีดังต่อไปนี้
รูปแบบตัวอย่างที่รองรับ
- H264 (คำอธิบายสื่อ SDP ต้องมีข้อมูล SPS/PPS ในแอตทริบิวต์ fmtp สำหรับการเริ่มต้นตัวถอดรหัส)
- AAC (ที่มีบิตสตรีม ADTS)
- AC3
ประเภทเครือข่ายที่รองรับ
- RTP ผ่าน UDP Unicast (ไม่รองรับ Multicast)
- RTSP แบบสลับ, RTP ผ่าน RTSP โดยใช้ TCP
การใช้ MediaItem
หากต้องการเล่นสตรีม RTSP คุณต้องใช้โมดูล RTSP
Kotlin
implementation("androidx.media3:media3-exoplayer-rtsp:1.11.1")
ดึงดูด
implementation "androidx.media3:media3-exoplayer-rtsp:1.11.1"
จากนั้นคุณสามารถสร้าง MediaItem สำหรับ RTSP URI และส่งไปยังโปรแกรมเล่นได้
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(rtspUri)) // Prepare the player. player.prepare()
Java
// Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(rtspUri)); // Prepare the player. player.prepare();
การตรวจสอบสิทธิ์
ExoPlayer รองรับการเล่นด้วยการตรวจสอบสิทธิ์ RTSP BASIC และ DIGEST หากต้องการเล่นเนื้อหา RTSP ที่ได้รับการคุ้มครอง คุณต้องกำหนดค่า URI ของ MediaItem ด้วยข้อมูลการตรวจสอบสิทธิ์ โดยเฉพาะอย่างยิ่ง URI ควรอยู่ในรูปแบบ rtsp://<username>:<password>@<host address>
การใช้ RtspMediaSource
หากต้องการตัวเลือกการปรับแต่งเพิ่มเติม คุณสามารถสร้าง RtspMediaSource และส่งไปยังเพลเยอร์โดยตรงแทน MediaItem
Kotlin
// Create an RTSP media source pointing to an RTSP uri. val mediaSource: MediaSource = RtspMediaSource.Factory().createMediaSource(MediaItem.fromUri(rtspUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
// Create an RTSP media source pointing to an RTSP uri. MediaSource mediaSource = new RtspMediaSource.Factory().createMediaSource(MediaItem.fromUri(rtspUri)); // Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media source to be played. player.setMediaSource(mediaSource); // Prepare the player. player.prepare();
การใช้ RTSP หลัง NAT (รองรับ RTP/TCP)
ExoPlayer ใช้ UDP เป็นโปรโตคอลเริ่มต้นสำหรับการส่ง RTP
เมื่อสตรีม RTSP หลังเลเยอร์ NAT แล้ว NAT อาจส่งต่อแพ็กเก็ต RTP/UDP ขาเข้าไปยังอุปกรณ์ไม่ได้ ซึ่งจะเกิดขึ้นหาก NAT ไม่มี การแมปพอร์ต UDP ที่จำเป็น หาก ExoPlayer ตรวจพบว่าไม่มีแพ็กเก็ต RTP เข้ามาเป็นระยะเวลาหนึ่งและยังไม่ได้เริ่มเล่น ExoPlayer จะยกเลิกเซสชันการเล่น RTSP ปัจจุบัน และลองเล่นอีกครั้งโดยใช้ RTP-over-RTSP (ส่งแพ็กเก็ต RTP โดยใช้การเชื่อมต่อ TCP ที่เปิดไว้สำหรับ RTSP)
คุณปรับแต่งระยะหมดเวลาสำหรับการลองใหม่ด้วย TCP ได้โดยเรียกใช้เมธอด RtspMediaSource.Factory.setTimeoutMs() ตัวอย่างเช่น หากตั้งค่าระยะหมดเวลาเป็น 4 วินาที เพลเยอร์จะลองอีกครั้งด้วย TCP หลังจากที่ไม่มีการใช้งาน UDP เป็นเวลา 4 วินาที
การตั้งค่าระยะหมดเวลายังส่งผลต่อตรรกะการตรวจจับการสิ้นสุดสตรีมด้วย กล่าวคือ ExoPlayer จะรายงานว่าการเล่นสิ้นสุดลงหากไม่ได้รับข้อมูลใดๆ ในช่วงระยะเวลาที่กำหนดหมดเวลา การตั้งค่านี้ให้มีค่าน้อยเกินไปอาจทำให้สัญญาณสิ้นสุดสตรีมเร็วเกินไปในสภาวะเครือข่ายที่ไม่ดี
RTP/TCP มีความเข้ากันได้ดีกว่าภายใต้การตั้งค่าเครือข่ายบางอย่าง คุณสามารถกำหนดค่า ExoPlayer ให้ใช้ RTP/TCP โดยค่าเริ่มต้นด้วย RtspMediaSource.Factory.setForceUseRtpTcp()
การส่ง SocketFactory ที่กำหนดเอง
อินสแตนซ์ SocketFactory ที่กำหนดเองจะมีประโยชน์เมื่อจำเป็นต้องมีการกำหนดเส้นทางเฉพาะ (เช่น เมื่อการรับส่งข้อมูล RTSP ต้องผ่านอินเทอร์เฟซเฉพาะ หรือซ็อกเก็ตต้องมีแฟล็กการเชื่อมต่อเพิ่มเติม)
โดยค่าเริ่มต้น RtspMediaSource จะใช้ซ็อกเก็ตแฟกทอรีมาตรฐานของ Java (SocketFactory.getDefault()) เพื่อสร้างการเชื่อมต่อกับปลายทางระยะไกล
ลักษณะการทำงานนี้ลบล้างได้โดยใช้ RtspMediaSource.Factory.setSocketFactory()
Kotlin
// Create an RTSP media source pointing to an RTSP uri and override the socket // factory. val mediaSource: MediaSource = RtspMediaSource.Factory() .setSocketFactory(socketFactory) .createMediaSource(MediaItem.fromUri(rtspUri))
Java
// Create an RTSP media source pointing to an RTSP uri and override the socket // factory. MediaSource mediaSource = new RtspMediaSource.Factory() .setSocketFactory(socketFactory) .createMediaSource(MediaItem.fromUri(rtspUri));