Nguyên tắc AEP: Media3

Tích hợp thư viện Jetpack Media3 làm tiêu chuẩn cho việc phát nội dung nghe nhìn, phiên, chỉnh sửa, siêu dữ liệu và trích xuất khung hình để đảm bảo các ứng dụng sử dụng API được đề xuất để xử lý các tác vụ phức tạp về nội dung nghe nhìn trên nhiều hệ số hình dạng của Android. Hiện đại hoá cấu trúc nội dung nghe nhìn bằng cách di chuyển từ các API khung cũ (chẳng hạn như MediaPlayer, MediaMuxer và MediaExtractor) sang thư viện Jetpack Media3 mạnh mẽ. Thư viện này cung cấp một bộ công cụ hợp nhất, giàu tính năng, đảm bảo trải nghiệm nhất quán về nội dung nghe nhìn.

Yêu cầu về việc triển khai

Để đủ điều kiện tham gia AEP, ứng dụng của bạn phải tuân thủ các yêu cầu sau:

  • Không nên sử dụng các API cũ của khung Android, bao gồm MediaPlayer, MediaExtractor, MediaMuxer và MediaMetadataRetriever.
  • Nếu hoạt động phát là một hành trình cốt lõi của người dùng, thì ứng dụng phải tích hợp các phiên nội dung nghe nhìn để hệ điều hành nhận biết và tích hợp trên nhiều thiết bị.
  • Nếu có thư viện nội dung âm thanh, ứng dụng phải hiển thị nội dung thông qua MediaLibraryService và triển khai tính năng hỗ trợ tiếp tục phát nội dung nghe nhìn.

Phạm vi áp dụng nguyên tắc

Nguyên tắc này áp dụng cho:

  • Ứng dụng hỗ trợ phát nội dung nghe nhìn (video hoặc âm thanh) hoặc chỉnh sửa video.
  • Đối với tất cả các kiểu dáng mà ứng dụng có thể dùng.

Miễn trừ

Các ứng dụng có thể sử dụng một khung thay thế tương đương, cung cấp chất lượng, khả năng của người dùng, độ ổn định và khả năng tương thích tương tự trên toàn hệ sinh thái. Liên hệ với nhóm hỗ trợ nếu bạn có một khuôn khổ phù hợp để chúng tôi xem xét. Để đủ điều kiện, giải pháp triển khai thay thế phải đáp ứng các tiêu chí sau:

  • Trên mạng có tốc độ cao, khung hình video đầu tiên phải hiển thị trong vòng 500 mili giây kể từ khi người dùng bắt đầu.
  • Quá trình phát phải diễn ra mượt mà, không bị rớt khung hình hoặc thiếu hụt âm thanh trong khoảng thời gian 30 giây.
  • Ứng dụng phải quản lý quyền phát âm thanh một cách thích hợp.
  • Ứng dụng phải phản hồi các phím điều khiển nội dung nghe nhìn trên phần cứng, ngay cả khi đang chạy ở chế độ nền.
  • Nếu hỗ trợ chế độ phát ở nền, ứng dụng phải đăng một thông báo theo kiểu nội dung nghe nhìn và sử dụng một dịch vụ trên nền trước.
  • Nếu hỗ trợ tiếp tục phát, ứng dụng phải triển khai tính năng tiếp tục phát nội dung nghe nhìn.
  • Bạn phải xử lý các trường hợp ngắt kết nối tai nghe một cách linh hoạt. Ví dụ: tạm dừng phát thay vì chuyển sang loa.
  • Quá trình phát phải tiếp tục mà không bị bỏ khung hình khi chuyển đổi giữa các hướng thiết bị.

Tài liệu và tài nguyên về tính năng

Các tài nguyên sau đây cung cấp hướng dẫn triển khai và thông tin kỹ thuật về tính năng Media3. Các tài nguyên này chỉ mang tính tham khảo và không chứa các yêu cầu bổ sung của chương trình.