ขวาไปซ้าย

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));