Ngăn xếp mạng

ExoPlayer thường được dùng để truyền trực tuyến nội dung nghe nhìn qua Internet. Thư viện này hỗ trợ nhiều bộ phần cứng và phần mềm mạng để thực hiện các yêu cầu mạng cơ bản. Lựa chọn của bạn về bộ phần cứng và phần mềm mạng có thể ảnh hưởng đáng kể đến hiệu suất truyền trực tuyến.

Trang này trình bày cách định cấu hình ExoPlayer để sử dụng bộ phần cứng và phần mềm mạng mà bạn chọn, liệt kê các tuỳ chọn có sẵn, đưa ra một số hướng dẫn về cách chọn bộ phần cứng và phần mềm mạng cho ứng dụng, đồng thời giải thích cách bật tính năng lưu vào bộ nhớ đệm cho nội dung nghe nhìn được truyền trực tuyến.

Định cấu hình ExoPlayer để sử dụng một bộ phần cứng và phần mềm mạng cụ thể

ExoPlayer tải dữ liệu thông qua các thành phần DataSource mà nó lấy được từ các thực thể DataSource.Factory được chèn từ mã ứng dụng.

Nếu ứng dụng của bạn chỉ cần phát nội dung http(s), thì việc chọn một bộ phần cứng và phần mềm mạng chỉ đơn giản là cập nhật mọi thực thể DataSource.Factory mà ứng dụng của bạn chèn vào để trở thành thực thể của HttpDataSource.Factory tương ứng với bộ phần cứng và phần mềm mạng mà bạn muốn sử dụng. Nếu ứng dụng của bạn cũng cần phát nội dung không phải http(s), chẳng hạn như tệp cục bộ, hãy sử dụng DefaultDataSource.Factory:

Kotlin

DefaultDataSource.Factory(
  context,
  /* baseDataSourceFactory= */ PreferredHttpDataSource.Factory(context),
)

Java

new DefaultDataSource.Factory(
    context, /* baseDataSourceFactory= */ new PreferredHttpDataSource.Factory(context));

Trong ví dụ này, PreferredHttpDataSource.Factory là nhà máy tương ứng với bộ phần cứng và phần mềm mạng mà bạn ưu tiên. Lớp DefaultDataSource.Factory bổ sung tính năng hỗ trợ cho các nguồn không phải http(s), chẳng hạn như tệp cục bộ.

Ví dụ sau đây cho thấy cách tạo một ExoPlayer sẽ sử dụng bộ phần cứng và phần mềm mạng Cronet, đồng thời hỗ trợ phát nội dung không phải http(s).

Kotlin

// Given a CronetEngine and Executor, build a CronetDataSource.Factory.
val cronetDataSourceFactory = CronetDataSource.Factory(cronetEngine, executor)

// Wrap the CronetDataSource.Factory in a DefaultDataSource.Factory, which adds
// in support for requesting data from other sources (such as files, resources,
// etc).
val dataSourceFactory =
  DefaultDataSource.Factory(context, /* baseDataSourceFactory= */ cronetDataSourceFactory)

// Inject the DefaultDataSource.Factory when creating the player.
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(
      DefaultMediaSourceFactory(context).setDataSourceFactory(dataSourceFactory)
    )
    .build()

Java

// Given a CronetEngine and Executor, build a CronetDataSource.Factory.
CronetDataSource.Factory cronetDataSourceFactory =
    new CronetDataSource.Factory(cronetEngine, executor);

// Wrap the CronetDataSource.Factory in a DefaultDataSource.Factory, which adds
// in support for requesting data from other sources (such as files, resources,
// etc).
DefaultDataSource.Factory dataSourceFactory =
    new DefaultDataSource.Factory(
        context, /* baseDataSourceFactory= */ cronetDataSourceFactory);

// Inject the DefaultDataSource.Factory when creating the player.
ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setDataSourceFactory(dataSourceFactory))
        .build();

Bộ phần cứng và phần mềm mạng được hỗ trợ

ExoPlayer hỗ trợ trực tiếp cho HttpEngine, Cronet, OkHttp và bộ phần cứng và phần mềm mạng mặc định tích hợp sẵn của Android. Bạn cũng có thể mở rộng ExoPlayer để hỗ trợ bất kỳ bộ phần cứng và phần mềm mạng nào khác hoạt động trên Android.

HttpEngine

HttpEngine là bộ phần cứng và phần mềm mạng mặc định được đề xuất trên Android từ API 34 (hoặc S extensions 7). Trong hầu hết các trường hợp, thư viện này sử dụng bộ phần cứng và phần mềm mạng Cronet trong nội bộ, hỗ trợ các giao thức HTTP, HTTP/2 và HTTP/3 qua QUIC.

ExoPlayer hỗ trợ HttpEngine bằng HttpEngineDataSource.Factory. Bạn có thể chèn nhà máy nguồn dữ liệu này như mô tả trong phần Định cấu hình ExoPlayer để sử dụng một bộ phần cứng và phần mềm mạng cụ thể.

Cronet

Cronet là bộ phần cứng và phần mềm mạng Chromium được dùng cho các ứng dụng Android dưới dạng thư viện. Cronet tận dụng nhiều công nghệ giúp giảm độ trễ và tăng công suất các yêu cầu mạng mà ứng dụng của bạn cần để hoạt động, bao gồm cả những yêu cầu do ExoPlayer thực hiện. Thư viện này hỗ trợ sẵn các giao thức HTTP, HTTP/2 và HTTP/3 qua QUIC. Cronet được một số ứng dụng phát trực tuyến lớn nhất thế giới sử dụng, bao gồm cả YouTube.

ExoPlayer hỗ trợ Cronet thông qua thư viện Cronet. Hãy xem README.md của thư viện để biết hướng dẫn chi tiết về cách sử dụng. Xin lưu ý rằng thư viện Cronet có thể sử dụng 3 cách triển khai Cronet cơ bản:

  1. Dịch vụ Google Play: Bạn nên sử dụng phương thức triển khai này trong hầu hết các trường hợp và quay lại bộ phần cứng và phần mềm mạng tích hợp sẵn của Android (DefaultHttpDataSource) nếu không có Dịch vụ Google Play.
  2. Cronet Embedded: Có thể là một lựa chọn phù hợp nếu phần lớn người dùng của bạn ở những thị trường không có sẵn Dịch vụ Google Play hoặc nếu bạn muốn kiểm soát phiên bản chính xác của quá trình triển khai Cronet đang được sử dụng. Nhược điểm lớn của Cronet Embedded là làm tăng kích thước ứng dụng thêm khoảng 8 MB.
  3. Dự phòng Cronet: Cách triển khai dự phòng của Cronet triển khai API của Cronet dưới dạng một trình bao bọc xung quanh bộ phần cứng và phần mềm mạng tích hợp sẵn của Android. Bạn không nên sử dụng thư viện này với ExoPlayer vì việc sử dụng trực tiếp bộ phần cứng và phần mềm mạng tích hợp sẵn của Android (bằng cách sử dụng DefaultHttpDataSource) sẽ hiệu quả hơn.

OkHttp

OkHttp là một bộ phần cứng và phần mềm mạng hiện đại khác được nhiều ứng dụng Android phổ biến sử dụng rộng rãi. Thư viện này hỗ trợ HTTP và HTTP/2, nhưng chưa hỗ trợ HTTP/3 qua QUIC.

ExoPlayer hỗ trợ OkHttp thông qua thư viện OkHttp. Hãy xem README.md của thư viện để biết hướng dẫn chi tiết về cách sử dụng. Khi sử dụng thư viện OkHttp, bộ phần cứng và phần mềm mạng sẽ được nhúng trong ứng dụng. Điều này tương tự như Cronet Embedded, tuy nhiên OkHttp nhỏ hơn đáng kể, chỉ thêm dưới 1 MB vào ứng dụng của bạn.

Bộ phần cứng và phần mềm mạng tích hợp sẵn của Android

ExoPlayer hỗ trợ việc sử dụng bộ phần cứng và phần mềm mạng tích hợp sẵn của Android với DefaultHttpDataSource và DefaultHttpDataSource.Factory, là một phần của thư viện ExoPlayer chính.

Việc triển khai bộ phần cứng và phần mềm mạng chính xác phụ thuộc vào phần mềm chạy trên thiết bị cơ bản. Trên hầu hết các thiết bị, chỉ có HTTP được hỗ trợ (tức là HTTP/2 và HTTP/3 qua QUIC không được hỗ trợ).

Các bộ phần cứng và phần mềm mạng khác

Ứng dụng cũng có thể tích hợp các bộ phần cứng và phần mềm mạng khác với ExoPlayer. Để làm việc này, hãy triển khai một HttpDataSource gói bộ phần cứng và phần mềm mạng, cùng với một HttpDataSource.Factory tương ứng. Thư viện Cronet và OkHttp của ExoPlayer là những ví dụ điển hình về cách thực hiện việc này.

Khi tích hợp với một bộ phần cứng và phần mềm mạng thuần Java, bạn nên triển khai một DataSourceContractTest (trong media3-test-utils) để kiểm tra xem quá trình triển khai HttpDataSource của bạn có hoạt động chính xác hay không. OkHttpDataSourceContractTest trong thư viện OkHttp là một ví dụ điển hình về cách thực hiện việc này. Để biết thêm thông tin về cấu phần phần mềm kiểm thử của Media3, hãy xem hướng dẫn kiểm thử.

Chọn bộ phần cứng và phần mềm mạng

Bảng sau đây trình bày ưu và nhược điểm của các bộ phần cứng và phần mềm mạng mà ExoPlayer hỗ trợ.

Bộ phần cứng và phần mềm mạng Giao thức Tác động đến kích thước tệp APK Ghi chú
HttpEngine HTTP
HTTP/2
HTTP/3 qua QUIC
Không có Chỉ có trên API 34 hoặc S Extensions 7
Cronet (Dịch vụ Google Play) HTTP
HTTP/2
HTTP/3 qua QUIC
Nhỏ
(<100 KB)
Cần có Dịch vụ Google Play. Phiên bản Cronet được cập nhật tự động
Cronet (Được nhúng) HTTP
HTTP/2
HTTP/3 qua QUIC
Lớn
(~8 MB)
Phiên bản Cronet do nhà phát triển ứng dụng kiểm soát
Cronet (Dự phòng) HTTP
(tuỳ theo thiết bị)
Nhỏ
(<100 KB)
Không nên dùng cho ExoPlayer
OkHttp HTTP
HTTP/2
Nhỏ
(<1 MB)
Bộ phần cứng và phần mềm mạng tích hợp sẵn HTTP
(tuỳ theo thiết bị)
Không có Cách triển khai tuỳ theo thiết bị

Giao thức HTTP/2 và HTTP/3 qua QUIC có thể cải thiện đáng kể hiệu suất truyền trực tuyến nội dung nghe nhìn. Cụ thể, khi truyền trực tuyến nội dung nghe nhìn thích ứng được phân phối bằng mạng phân phối nội dung (CDN), có những trường hợp việc sử dụng các giao thức này có thể giúp CDN hoạt động hiệu quả hơn nhiều. Vì lý do này, việc HttpEngine và Cronet hỗ trợ cả HTTP/2 và HTTP/3 qua QUIC (và OkHttp hỗ trợ HTTP/2) là một lợi ích lớn so với việc sử dụng bộ phần cứng và phần mềm mạng tích hợp sẵn của Android, miễn là các máy chủ lưu trữ nội dung cũng hỗ trợ các giao thức này.

Khi xem xét riêng việc truyền trực tuyến nội dung nghe nhìn, bạn nên sử dụng HttpEngine hoặc Cronet do Dịch vụ Google Play cung cấp, quay lại DefaultHttpDataSource nếu không có Dịch vụ Google Play. Đề xuất này giúp cân bằng giữa việc cho phép sử dụng HTTP/2 và HTTP/3 qua QUIC trên hầu hết các thiết bị và tránh tăng đáng kể kích thước tệp APK. Có một số trường hợp ngoại lệ đối với đề xuất này. Đối với những trường hợp có khả năng không có Dịch vụ Google Play trên một phần đáng kể thiết bị sẽ chạy ứng dụng của bạn, thì việc sử dụng Cronet Embedded hoặc OkHttp có thể phù hợp hơn. Bạn có thể sử dụng bộ phần cứng và phần mềm mạng tích hợp sẵn nếu kích thước tệp APK là mối lo ngại quan trọng hoặc nếu việc truyền trực tuyến nội dung nghe nhìn chỉ là một phần nhỏ trong chức năng của ứng dụng.

Ngoài nội dung nghe nhìn, bạn nên chọn một bộ phần cứng và phần mềm mạng duy nhất cho tất cả hoạt động kết nối mạng mà ứng dụng của bạn thực hiện. Điều này cho phép các tài nguyên (chẳng hạn như cổng kết nối) được gộp và chia sẻ một cách hiệu quả giữa ExoPlayer và các thành phần khác của ứng dụng.

Vì ứng dụng của bạn rất có thể sẽ cần thực hiện hoạt động kết nối mạng không liên quan đến việc phát nội dung nghe nhìn, nên lựa chọn của bạn về bộ phần cứng và phần mềm mạng cuối cùng phải dựa trên các đề xuất của chúng tôi ở trên về việc truyền trực tuyến nội dung nghe nhìn riêng biệt, yêu cầu của mọi thành phần khác thực hiện hoạt động kết nối mạng và tầm quan trọng tương đối của các thành phần đó đối với ứng dụng của bạn.

Đang lưu nội dung nghe nhìn vào bộ nhớ đệm

ExoPlayer hỗ trợ lưu các byte đã tải vào bộ nhớ đệm trên ổ đĩa để tránh tải nhiều lần cùng một byte từ mạng. Điều này rất hữu ích khi tua lại trong nội dung nghe nhìn hiện tại hoặc lặp lại cùng một mục.

Việc lưu vào bộ nhớ đệm yêu cầu một thực thể SimpleCache trỏ đến một thư mục bộ nhớ đệm chuyên dụng và một CacheDataSource.Factory:

Kotlin

// Note: This should be a singleton in your app.
val databaseProvider = StandaloneDatabaseProvider(context)

// An on-the-fly cache should evict media when reaching a maximum disk space limit.
val cache =
  SimpleCache(downloadDirectory, LeastRecentlyUsedCacheEvictor(maxBytes), databaseProvider)

// Configure the DataSource.Factory with the cache and factory for the desired HTTP stack.
val cacheDataSourceFactory =
  CacheDataSource.Factory().setCache(cache).setUpstreamDataSourceFactory(httpDataSourceFactory)

// Inject the DefaultDataSource.Factory when creating the player.
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(
      DefaultMediaSourceFactory(context).setDataSourceFactory(cacheDataSourceFactory)
    )
    .build()

Java

// Note: This should be a singleton in your app.
DatabaseProvider databaseProvider = new StandaloneDatabaseProvider(context);

// An on-the-fly cache should evict media when reaching a maximum disk space limit.
Cache cache =
    new SimpleCache(
        downloadDirectory, new LeastRecentlyUsedCacheEvictor(maxBytes), databaseProvider);

// Configure the DataSource.Factory with the cache and factory for the desired HTTP stack.
DataSource.Factory cacheDataSourceFactory =
    new CacheDataSource.Factory()
        .setCache(cache)
        .setUpstreamDataSourceFactory(httpDataSourceFactory);

// Inject the DefaultDataSource.Factory when creating the player.
ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setDataSourceFactory(cacheDataSourceFactory))
        .build();