ExoPlayer phát hầu hết các sự kiện phát trực tiếp thích ứng ngay lập tức mà không cần bất kỳ cấu hình đặc biệt nào. Hãy xem trang Định dạng được hỗ trợ để biết thêm thông tin chi tiết.
Sự kiện phát trực tiếp thích ứng cung cấp một khoảng thời gian cho nội dung nghe nhìn có sẵn, được cập nhật theo khoảng thời gian đều đặn để di chuyển theo thời gian thực hiện tại. Điều này có nghĩa là vị trí phát sẽ luôn nằm trong cửa sổ này, trong hầu hết các trường hợp, vị trí này gần với thời gian thực hiện tại mà luồng đang được tạo. Sự khác biệt giữa thời gian theo thời gian thực hiện tại và vị trí phát lại được gọi là độ lệch trực tiếp.
Phát hiện và giám sát các lượt phát trực tiếp
Mỗi khi cửa sổ trực tiếp được cập nhật, các thực thể Player.Listener đã đăng ký sẽ nhận được một sự kiện onTimelineChanged. Bạn có thể truy xuất thông tin chi tiết về quá trình phát trực tiếp hiện tại bằng cách truy vấn nhiều phương thức Player và Timeline.Window, như được liệt kê sau và minh hoạ trong hình dưới đây.
Player.isCurrentWindowLivecho biết liệu mục nội dung nghe nhìn đang phát có phải là sự kiện phát trực tiếp hay không. Giá trị này vẫn đúng ngay cả khi sự kiện phát trực tiếp đã kết thúc.Player.isCurrentWindowDynamiccho biết liệu mục nội dung nghe nhìn đang phát có còn được cập nhật hay không. Điều này thường đúng với những sự kiện phát trực tiếp chưa kết thúc. Xin lưu ý rằng cờ này cũng đúng với các sự kiện phát trực tiếp không trực tiếp trong một số trường hợp.Player.getCurrentLiveOffsettrả về độ lệch giữa thời gian thực hiện tại và vị trí phát (nếu có).Player.getDurationtrả về thời lượng của cửa sổ phát trực tiếp hiện tại.Player.getCurrentPositiontrả về vị trí phát tương ứng với thời điểm bắt đầu của cửa sổ phát trực tiếp.Player.getCurrentMediaItemtrả về mục nội dung nghe nhìn hiện tại, trong đóMediaItem.liveConfigurationchứa các giá trị ghi đè do ứng dụng cung cấp cho độ lệch trực tiếp mục tiêu và các tham số điều chỉnh độ lệch trực tiếp.Player.getCurrentTimelinetrả về cấu trúc nội dung nghe nhìn hiện tại trongTimeline. Bạn có thể truy xuấtTimeline.Windowhiện tại từTimelinebằng cách sử dụngPlayer.getCurrentMediaItemIndexvàTimeline.getWindow. TrongWindow:Window.liveConfigurationchứa độ lệch trực tiếp mục tiêu và các tham số điều chỉnh độ lệch trực tiếp. Các giá trị này dựa trên thông tin trong nội dung nghe nhìn và mọi giá trị ghi đè do ứng dụng cung cấp được đặt trongMediaItem.liveConfiguration.Window.windowStartTimeMslà thời gian kể từ thời gian Unix mà tại đó khung thời gian phát trực tiếp bắt đầu.Window.getCurrentUnixTimeMslà thời gian kể từ thời gian bắt đầu của hệ thống Unix của thời gian thực hiện tại. Giá trị này có thể được điều chỉnh bằng sự chênh lệch đồng hồ đã biết giữa máy chủ và máy khách.Window.getDefaultPositionMslà vị trí trong cửa sổ phát trực tiếp mà tại đó trình phát sẽ bắt đầu phát theo mặc định.
Tua trong sự kiện phát trực tiếp
Bạn có thể tua đến bất kỳ vị trí nào trong cửa sổ phát trực tiếp bằng Player.seekTo. Vị trí tua được truyền có liên quan đến thời điểm bắt đầu của cửa sổ phát trực tiếp. Ví dụ: seekTo(0) sẽ tua đến đầu cửa sổ phát trực tiếp. Trình phát sẽ cố gắng giữ nguyên độ lệch trực tiếp như vị trí được tìm kiếm sau khi tìm kiếm.
Cửa sổ phát trực tiếp cũng có một vị trí mặc định mà tại đó quá trình phát được cho là sẽ bắt đầu. Vị trí này thường nằm gần điểm phát trực tiếp. Bạn có thể tua đến vị trí mặc định bằng cách gọi Player.seekToDefaultPosition.
Giao diện người dùng phát trực tiếp
Các thành phần giao diện người dùng mặc định của ExoPlayer cho thấy thời lượng của cửa sổ phát trực tiếp và vị trí phát hiện tại trong đó. Điều này có nghĩa là vị trí có vẻ như lùi lại mỗi khi cửa sổ phát trực tiếp được cập nhật. Nếu cần hành vi khác, chẳng hạn như hiển thị thời gian Unix hoặc độ lệch trực tiếp hiện tại, bạn có thể phát triển nhánh PlayerControlView và sửa đổi cho phù hợp với nhu cầu của mình.
Định cấu hình các tham số phát trực tiếp
ExoPlayer sử dụng một số tham số để kiểm soát độ lệch của vị trí phát so với biên trực tiếp và phạm vi tốc độ phát có thể dùng để điều chỉnh độ lệch này.
ExoPlayer lấy giá trị cho các tham số này từ ba nơi, theo thứ tự ưu tiên giảm dần (giá trị đầu tiên tìm thấy sẽ được sử dụng):
- Giá trị
MediaItemđược truyền choMediaItem.Builder.setLiveConfiguration. - Giá trị mặc định chung được đặt vào ngày
DefaultMediaSourceFactory. - Giá trị được đọc trực tiếp từ nội dung nghe nhìn.
Kotlin
// Global settings. val player = ExoPlayer.Builder(context) .setMediaSourceFactory(DefaultMediaSourceFactory(context).setLiveTargetOffsetMs(5000)) .build() // Per MediaItem settings. val mediaItem = MediaItem.Builder() .setUri(mediaUri) .setLiveConfiguration( MediaItem.LiveConfiguration.Builder().setMaxPlaybackSpeed(1.02f).build() ) .build() player.setMediaItem(mediaItem)
Java
// Global settings. ExoPlayer player = new ExoPlayer.Builder(context) .setMediaSourceFactory( new DefaultMediaSourceFactory(context).setLiveTargetOffsetMs(5000)) .build(); // Per MediaItem settings. MediaItem mediaItem = new MediaItem.Builder() .setUri(mediaUri) .setLiveConfiguration( new MediaItem.LiveConfiguration.Builder().setMaxPlaybackSpeed(1.02f).build()) .build(); player.setMediaItem(mediaItem);
Các giá trị cấu hình có thể sử dụng là:
targetOffsetMs: Độ lệch mục tiêu của sự kiện phát trực tiếp. Trình phát sẽ cố gắng đạt được độ lệch trực tiếp gần với giá trị này trong khi phát nếu có thể.minOffsetMs: Độ lệch tối thiểu cho phép khi phát trực tiếp. Ngay cả khi điều chỉnh độ lệch theo điều kiện mạng hiện tại, trình phát cũng sẽ không cố gắng giảm xuống thấp hơn độ lệch này trong khi phát.maxOffsetMs: Độ lệch tối đa cho phép khi phát trực tiếp. Ngay cả khi điều chỉnh độ lệch theo điều kiện mạng hiện tại, trình phát cũng sẽ không cố gắng vượt quá độ lệch này trong khi phát.minPlaybackSpeed: Tốc độ phát tối thiểu mà trình phát có thể sử dụng để quay lại khi cố gắng đạt đến độ lệch trực tiếp mục tiêu.maxPlaybackSpeed: Tốc độ phát tối đa mà trình phát có thể sử dụng để bắt kịp khi cố gắng đạt đến độ lệch trực tiếp mục tiêu.
Điều chỉnh tốc độ phát
Khi phát một sự kiện phát trực tiếp có độ trễ thấp, ExoPlayer sẽ điều chỉnh độ lệch trực tiếp bằng cách thay đổi một chút tốc độ phát. Trình phát sẽ cố gắng khớp với độ lệch trực tiếp mục tiêu do nội dung nghe nhìn hoặc ứng dụng cung cấp, nhưng cũng sẽ cố gắng phản ứng với các điều kiện mạng thay đổi. Ví dụ: nếu xảy ra tình trạng tải lại vùng đệm trong khi phát, thì trình phát sẽ làm chậm quá trình phát một chút để di chuyển ra xa hơn khỏi biên trực tiếp. Nếu sau đó mạng đủ ổn định để hỗ trợ phát gần thời điểm phát trực tiếp hơn, thì trình phát sẽ tăng tốc độ phát để quay lại độ lệch trực tiếp mục tiêu.
Nếu không cần tự động điều chỉnh tốc độ phát, bạn có thể tắt tính năng này bằng cách đặt các thuộc tính minPlaybackSpeed và maxPlaybackSpeed thành 1.0f.
Tương tự, bạn có thể bật tính năng này cho các sự kiện phát trực tiếp không có độ trễ thấp bằng cách đặt rõ ràng các giá trị này thành giá trị khác 1.0f. Hãy xem phần cấu hình để biết thêm thông tin chi tiết về cách đặt các thuộc tính này.
Tuỳ chỉnh thuật toán điều chỉnh tốc độ phát
Nếu bạn bật tính năng điều chỉnh tốc độ, thì LivePlaybackSpeedControl sẽ xác định những điều chỉnh được thực hiện. Bạn có thể triển khai LivePlaybackSpeedControl tuỳ chỉnh hoặc tuỳ chỉnh cách triển khai mặc định, tức là DefaultLivePlaybackSpeedControl. Trong cả hai trường hợp, bạn có thể đặt một thực thể khi tạo trình phát:
Kotlin
val player = ExoPlayer.Builder(context) .setLivePlaybackSpeedControl( DefaultLivePlaybackSpeedControl.Builder().setFallbackMaxPlaybackSpeed(1.04f).build() ) .build()
Java
ExoPlayer player = new ExoPlayer.Builder(context) .setLivePlaybackSpeedControl( new DefaultLivePlaybackSpeedControl.Builder() .setFallbackMaxPlaybackSpeed(1.04f) .build()) .build();
Các tham số tuỳ chỉnh có liên quan của DefaultLivePlaybackSpeedControl là:
fallbackMinPlaybackSpeedvàfallbackMaxPlaybackSpeed: Tốc độ phát tối thiểu và tối đa có thể dùng để điều chỉnh nếu cả nội dung nghe nhìn vàMediaItemdo ứng dụng cung cấp đều không xác định giới hạn.proportionalControlFactor: Kiểm soát mức độ mượt mà của việc điều chỉnh tốc độ. Giá trị cao giúp việc điều chỉnh diễn ra đột ngột và nhanh hơn, nhưng cũng dễ nghe thấy hơn. Giá trị càng nhỏ thì quá trình chuyển đổi giữa các tốc độ càng mượt mà, nhưng tốc độ sẽ chậm hơn.targetLiveOffsetIncrementOnRebufferMs: Giá trị này được thêm vào độ lệch trực tiếp mục tiêu bất cứ khi nào xảy ra hiện tượng lưu vào vùng đệm lại, để tiến hành một cách thận trọng hơn. Bạn có thể tắt tính năng này bằng cách đặt giá trị thành 0.minPossibleLiveOffsetSmoothingFactor: Hệ số làm mượt luỹ thừa được dùng để theo dõi độ lệch trực tiếp tối thiểu có thể dựa trên nội dung nghe nhìn hiện được lưu vào vùng đệm. Giá trị rất gần với 1 có nghĩa là thông tin ước tính thận trọng hơn và có thể mất nhiều thời gian hơn để điều chỉnh theo điều kiện mạng được cải thiện, trong khi giá trị thấp hơn có nghĩa là thông tin ước tính sẽ điều chỉnh nhanh hơn nhưng có nguy cơ gặp phải tình trạng tải lại vào vùng đệm cao hơn.
BehindLiveWindowException và ERROR_CODE_BEHIND_LIVE_WINDOW
Vị trí phát có thể bị chậm hơn so với cửa sổ phát trực tiếp, ví dụ: nếu trình phát bị tạm dừng hoặc lưu vào vùng đệm trong một khoảng thời gian đủ dài. Nếu điều này xảy ra, quá trình phát sẽ không thành công và một ngoại lệ có mã lỗi ERROR_CODE_BEHIND_LIVE_WINDOW sẽ được báo cáo bằng Player.Listener.onPlayerError. Bạn nên xử lý các lỗi như vậy bằng cách tiếp tục phát ở vị trí mặc định. PlayerActivity của ứng dụng minh hoạ là ví dụ minh hoạ cho phương pháp này.
Kotlin
override fun onPlayerError(error: PlaybackException) { if (error.errorCode == PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW) { // Re-initialize player at the live edge. player.seekToDefaultPosition() player.prepare() } else { // Handle other errors } }
Java
@Override public void onPlayerError(PlaybackException error) { if (error.errorCode == PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW) { // Re-initialize player at the live edge. player.seekToDefaultPosition(); player.prepare(); } else { // Handle other errors } }