RTSP

ExoPlayer hỗ trợ cả RTSP trực tiếp và theo yêu cầu. Các định dạng mẫu và loại mạng được hỗ trợ được liệt kê bên dưới.

Định dạng mẫu được hỗ trợ

  • H264 (nội dung mô tả phương tiện SDP phải bao gồm dữ liệu SPS/PPS trong thuộc tính fmtp để khởi tạo bộ giải mã).
  • AAC (có luồng bit ADTS).
  • AC3.

Các loại mạng được hỗ trợ

  • RTP qua UDP đơn hướng (không hỗ trợ truyền đa hướng).
  • RTSP xen kẽ, RTP qua RTSP bằng TCP.

Sử dụng MediaItem

Để phát một luồng RTSP, bạn cần phụ thuộc vào mô-đun RTSP.

Kotlin

implementation("androidx.media3:media3-exoplayer-rtsp:1.7.1")

Groovy

implementation "androidx.media3:media3-exoplayer-rtsp:1.7.1"

Sau đó, bạn có thể tạo một MediaItem cho URI RTSP và truyền URI đó đến trình phát.

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

Xác thực

ExoPlayer hỗ trợ phát bằng phương thức xác thực RTSP BASIC và DIGEST. Để phát nội dung RTSP được bảo vệ, bạn phải định cấu hình URI của MediaItem bằng thông tin xác thực. Cụ thể, URI phải có dạng rtsp://<username>:<password>@<host address>.

Sử dụng RtspMediaSource

Để có thêm các lựa chọn tuỳ chỉnh, bạn có thể tạo một RtspMediaSource và truyền trực tiếp đến trình phát thay vì 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();

Sử dụng RTSP đằng sau NAT (hỗ trợ RTP/TCP)

ExoPlayer sử dụng UDP làm giao thức mặc định cho việc truyền tải RTP.

Khi truyền phát trực tiếp RTSP đằng sau một lớp NAT, NAT có thể không chuyển tiếp được các gói RTP/UDP đến thiết bị. Điều này xảy ra nếu NAT thiếu chế độ ánh xạ cổng UDP cần thiết. Nếu ExoPlayer phát hiện không có gói RTP nào đến trong một thời gian và quá trình phát chưa bắt đầu, thì ExoPlayer sẽ huỷ phiên phát RTSP hiện tại và thử lại quá trình phát bằng RTP qua RTSP (truyền gói RTP bằng kết nối TCP được mở cho RTSP).

Bạn có thể tuỳ chỉnh thời gian chờ để thử lại bằng TCP bằng cách gọi phương thức RtspMediaSource.Factory.setTimeoutMs(). Ví dụ: nếu thời gian chờ được đặt thành 4 giây, thì trình phát sẽ thử lại bằng TCP sau 4 giây không hoạt động của UDP.

Việc đặt thời gian chờ cũng ảnh hưởng đến logic phát hiện cuối luồng. Tức là ExoPlayer sẽ báo cáo rằng quá trình phát đã kết thúc nếu không nhận được dữ liệu nào trong khoảng thời gian chờ đã đặt. Việc đặt giá trị này quá nhỏ có thể dẫn đến tín hiệu kết thúc luồng sớm trong điều kiện mạng kém.

RTP/TCP mang lại khả năng tương thích tốt hơn trong một số chế độ thiết lập mạng. Bạn có thể định cấu hình ExoPlayer để sử dụng RTP/TCP theo mặc định bằng RtspMediaSource.Factory.setForceUseRtpTcp().

Truyền một SocketFactory tuỳ chỉnh

Các thực thể SocketFactory tuỳ chỉnh có thể hữu ích khi cần có một quy trình định tuyến cụ thể (ví dụ: khi lưu lượng truy cập RTSP cần truyền qua một giao diện cụ thể hoặc socket cần có thêm cờ kết nối).

Theo mặc định, RtspMediaSource sẽ sử dụng nhà máy ổ cắm tiêu chuẩn của Java (SocketFactory.getDefault()) để tạo các kết nối đến các điểm cuối từ xa. Bạn có thể ghi đè hành vi này bằng cách sử dụng 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(...)
    .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(...)
        .createMediaSource(MediaItem.fromUri(rtspUri));