- Khắc phục lỗi "Không cho phép lưu lượng truy cập HTTP văn bản thô"
- Khắc phục lỗi "SSLHandshakeException", "CertPathValidatorException" và "ERR_CERT_AUTHORITY_INVALID"
- Tại sao một số tệp nội dung nghe nhìn không thể tua được?
- Tại sao việc tua không chính xác trong một số tệp MP3?
- Tại sao việc tua trong video của tôi lại chậm?
- Tại sao một số tệp MPEG-TS không phát được?
- Tại sao không tìm thấy phụ đề trong một số tệp MPEG-TS?
- Tại sao một số tệp MP4/FMP4 phát không chính xác?
- Tại sao một số luồng không thành công với mã phản hồi HTTP 301 hoặc 302?
- Tại sao một số luồng không thành công và gặp lỗi UnrecognizedInputFormatException?
- Tại sao setPlaybackParameters không hoạt động đúng cách trên một số thiết bị?
- Lỗi "Trình phát được truy cập trên luồng không chính xác" có nghĩa là gì?
- Làm cách nào để khắc phục lỗi "Dòng trạng thái không mong muốn: ICY 200 OK"?
- Làm cách nào để truy vấn xem luồng đang phát có phải là sự kiện phát trực tiếp hay không?
- Làm cách nào để tiếp tục phát âm thanh khi ứng dụng của tôi chạy ở chế độ nền?
- Tại sao ExoPlayer hỗ trợ nội dung của tôi nhưng thư viện ExoPlayer Cast thì không?
- Tại sao nội dung không phát được nhưng không có lỗi nào xuất hiện?
- Làm cách nào để tải thư viện giải mã và sử dụng thư viện đó để phát?
- Tôi có thể phát video trên YouTube trực tiếp bằng ExoPlayer không?
- Video phát bị giật
- Lỗi tìm lỗi mã nguồn API không ổn định
- Làm cách nào để thử nghiệm hoặc tách biệt các vấn đề do các tính năng hoặc biện pháp tối ưu hoá mới gây ra?
Khắc phục lỗi "Không cho phép lưu lượng truy cập HTTP văn bản thô"
Lỗi này sẽ xảy ra nếu ứng dụng của bạn yêu cầu lưu lượng truy cập HTTP qua văn bản thô (tức là http:// thay vì https://) khi Cấu hình bảo mật mạng không cho phép. Nếu ứng dụng của bạn nhắm đến Android 9 (cấp độ API 28) trở lên, thì lưu lượng truy cập HTTP văn bản thô sẽ bị tắt theo cấu hình mặc định.
Nếu ứng dụng của bạn cần hoạt động với lưu lượng truy cập HTTP qua văn bản thô, thì bạn cần sử dụng Cấu hình bảo mật mạng cho phép điều đó. Hãy xem tài liệu về bảo mật mạng của Android để biết thông tin chi tiết. Để bật tất cả lưu lượng truy cập HTTP văn bản thô, bạn chỉ cần thêm android:usesCleartextTraffic="true" vào phần tử application của AndroidManifest.xml trong ứng dụng.
Ứng dụng minh hoạ ExoPlayer sử dụng Cấu hình bảo mật mạng mặc định, nên không cho phép lưu lượng truy cập HTTP qua văn bản thô. Bạn có thể bật tính năng này theo hướng dẫn ở trên.
Khắc phục lỗi "SSLHandshakeException", "CertPathValidatorException" và "ERR_CERT_AUTHORITY_INVALID"
SSLHandshakeException, CertPathValidatorException và ERR_CERT_AUTHORITY_INVALID đều cho biết có vấn đề với chứng chỉ SSL của máy chủ. Các lỗi này không dành riêng cho ExoPlayer. Hãy xem
tài liệu về SSL của Android
để biết thêm thông tin chi tiết.
Tại sao một số tệp nội dung nghe nhìn không thể tua được?
Theo mặc định, ExoPlayer không hỗ trợ tua trong nội dung nghe nhìn khi phương thức duy nhất để thực hiện các thao tác tua chính xác là trình phát quét và lập chỉ mục toàn bộ tệp. ExoPlayer coi các tệp như vậy là không thể tua được. Hầu hết các định dạng vùng chứa nội dung nghe nhìn hiện đại đều bao gồm siêu dữ liệu để tìm kiếm (chẳng hạn như chỉ mục mẫu), có thuật toán tìm kiếm được xác định rõ (ví dụ: tìm kiếm phân đôi nội suy cho Ogg) hoặc cho biết nội dung của chúng có tốc độ bit không đổi. Trong những trường hợp này, ExoPlayer có thể thực hiện và hỗ trợ các thao tác tìm kiếm hiệu quả.
Nếu bạn cần tua nhưng có nội dung nghe nhìn không thể tua, bạn nên chuyển đổi nội dung để sử dụng định dạng vùng chứa phù hợp hơn. Đối với các tệp MP3, ADTS và AMR, bạn cũng có thể bật tính năng tua với giả định rằng các tệp có tốc độ bit không đổi, như mô tả tại đây.
Tại sao việc tua lại không chính xác trong một số tệp MP3?
Tệp MP3 có tốc độ bit biến đổi (VBR) về cơ bản không phù hợp với các trường hợp sử dụng yêu cầu tua chính xác. Có hai lý do cho việc này:
- Để tua chính xác, định dạng vùng chứa lý tưởng nhất là cung cấp một mối liên kết chính xác giữa thời gian và byte trong tiêu đề. Việc liên kết này cho phép người chơi liên kết thời gian tua đã yêu cầu với độ lệch byte tương ứng, đồng thời bắt đầu yêu cầu, phân tích cú pháp và phát nội dung nghe nhìn từ độ lệch đó. Rất tiếc, các tiêu đề có sẵn để chỉ định mối liên kết này trong MP3 (chẳng hạn như tiêu đề XING) thường không chính xác.
- Đối với các định dạng vùng chứa không cung cấp mối liên kết chính xác giữa thời gian và byte (hoặc không có mối liên kết nào giữa thời gian và byte), bạn vẫn có thể thực hiện thao tác tua chính xác nếu vùng chứa đó có dấu thời gian tuyệt đối của mẫu trong luồng. Trong trường hợp này, trình phát có thể liên kết thời gian tua đến giá trị phỏng đoán chính xác nhất của độ lệch byte tương ứng, bắt đầu yêu cầu nội dung nghe nhìn từ độ lệch đó, phân tích cú pháp dấu thời gian tuyệt đối đầu tiên của mẫu và thực hiện hiệu quả thao tác tìm kiếm nhị phân có hướng dẫn vào nội dung nghe nhìn cho đến khi tìm thấy mẫu phù hợp. Rất tiếc, MP3 không bao gồm dấu thời gian mẫu tuyệt đối trong luồng, vì vậy, bạn không thể áp dụng phương pháp này.
Vì những lý do này, cách duy nhất để thực hiện thao tác tua chính xác vào tệp MP3 VBR là quét toàn bộ tệp và tạo thủ công một bản ánh xạ thời gian thành byte trong trình phát. Bạn có thể bật chiến lược này bằng cách sử dụng FLAG_ENABLE_INDEX_SEEKING,
có thể đặt trên DefaultExtractorsFactory bằng cách sử dụng
setMp3ExtractorFlags. Xin lưu ý rằng định dạng này không phù hợp với các tệp MP3 lớn, đặc biệt là nếu người dùng cố gắng tua đến gần cuối luồng ngay sau khi bắt đầu phát, thì trình phát phải đợi cho đến khi tải xuống và lập chỉ mục toàn bộ luồng trước khi thực hiện thao tác tua. Trong ExoPlayer, chúng tôi quyết định tối ưu hoá tốc độ thay vì độ chính xác trong trường hợp này, do đó, FLAG_ENABLE_INDEX_SEEKING bị tắt theo mặc định.
Nếu bạn kiểm soát nội dung nghe nhìn đang phát, bạn nên sử dụng định dạng vùng chứa phù hợp hơn, chẳng hạn như MP4. Chúng tôi không biết trường hợp sử dụng nào mà MP3 là lựa chọn định dạng nội dung nghe nhìn tốt nhất.
Tại sao việc tua trong video của tôi lại chậm?
Khi trình phát tua đến một vị trí phát mới trong video, trình phát cần thực hiện hai việc:
- Tải dữ liệu tương ứng với vị trí phát mới vào vùng đệm (bước này có thể không cần thiết nếu dữ liệu này đã được lưu vào vùng đệm).
- Xoá bộ giải mã video và bắt đầu giải mã từ khung hình I (khung hình chính) trước vị trí phát mới, do hầu hết các định dạng nén video đều sử dụng mã hoá trong khung hình. Để đảm bảo việc tua là chính xác (tức là quá trình phát bắt đầu chính xác tại vị trí tua), tất cả khung hình giữa khung hình I trước đó và vị trí tua cần được giải mã và loại bỏ ngay lập tức (mà không hiển thị trên màn hình).
Bạn có thể giảm độ trễ do (1) gây ra bằng cách tăng lượng dữ liệu được lưu vào bộ nhớ đệm của trình phát hoặc lưu trước dữ liệu vào bộ nhớ đệm trên ổ đĩa.
Bạn có thể giảm độ trễ do (2) gây ra bằng cách giảm độ chính xác của thao tác tua bằng ExoPlayer.setSeekParameters hoặc mã hoá lại video để có nhiều khung hình I thường xuyên hơn (điều này sẽ dẫn đến tệp đầu ra lớn hơn).
Nếu thao tác tua chậm khi người dùng kéo thanh tua, hãy bật chế độ kéo để tua (ExoPlayer.setScrubbingModeEnabled) để kết hợp các thao tác tua nhanh, tăng công suất của bộ giải mã và hỗ trợ đặt dung sai tua phân số dựa trên chiều rộng của thanh tua nhanh trên giao diện người dùng.
Tại sao một số tệp MPEG-TS không phát được?
Một số tệp MPEG-TS không chứa dấu phân tách đơn vị truy cập (AUD). Theo mặc định, ExoPlayer dựa vào AUD để phát hiện ranh giới khung hình một cách dễ dàng. Tương tự, một số tệp MPEG-TS không chứa khung hình chính IDR. Theo mặc định, đây là loại khung hình chính duy nhất mà ExoPlayer xem xét.
ExoPlayer sẽ có vẻ như bị kẹt ở trạng thái lưu vào vùng đệm khi được yêu cầu phát một tệp MPEG-TS thiếu AUD hoặc khung hình chính IDR. Nếu cần phát các tệp như vậy,
bạn có thể làm như vậy bằng cách sử dụng FLAG_DETECT_ACCESS_UNITS và
FLAG_ALLOW_NON_IDR_KEYFRAMES tương ứng. Bạn có thể đặt các cờ này trên DefaultExtractorsFactory bằng cách sử dụng setTsExtractorFlags hoặc trên DefaultHlsExtractorFactory bằng cách sử dụng hàm khởi tạo.
Việc sử dụng FLAG_DETECT_ACCESS_UNITS không có tác dụng phụ nào khác ngoài việc tốn kém về mặt tính toán so với việc phát hiện ranh giới khung dựa trên AUD. Việc sử dụng FLAG_ALLOW_NON_IDR_KEYFRAMES có thể dẫn đến hỏng hình ảnh tạm thời khi bắt đầu phát và ngay sau khi tua khi phát một số tệp MPEG-TS.
Tại sao không tìm thấy phụ đề trong một số tệp MPEG-TS?
Một số tệp MPEG-TS có chứa các bản nhạc CEA-608 nhưng không khai báo các bản nhạc đó trong siêu dữ liệu vùng chứa, vì vậy ExoPlayer không thể phát hiện các bản nhạc đó. Bạn có thể chỉ định thủ công bất kỳ bản phụ đề nào bằng cách cung cấp danh sách các định dạng phụ đề dự kiến cho DefaultExtractorsFactory, bao gồm cả các kênh hỗ trợ tiếp cận có thể dùng để xác định các định dạng đó trong luồng MPEG-TS:
Kotlin
val extractorsFactory = DefaultExtractorsFactory() .setTsSubtitleFormats( listOf( Format.Builder() .setSampleMimeType(MimeTypes.APPLICATION_CEA608) .setAccessibilityChannel(accessibilityChannel) // Set other subtitle format info, such as language. .build() ) ) val player: Player = ExoPlayer.Builder(context, DefaultMediaSourceFactory(context, extractorsFactory)).build()
Java
DefaultExtractorsFactory extractorsFactory = new DefaultExtractorsFactory() .setTsSubtitleFormats( ImmutableList.of( new Format.Builder() .setSampleMimeType(MimeTypes.APPLICATION_CEA608) .setAccessibilityChannel(accessibilityChannel) // Set other subtitle format info, such as language. .build())); Player player = new ExoPlayer.Builder(context, new DefaultMediaSourceFactory(context, extractorsFactory)) .build();
Tại sao một số tệp MP4/FMP4 phát không chính xác?
Một số tệp MP4/FMP4 chứa danh sách chỉnh sửa giúp viết lại dòng thời gian của nội dung nghe nhìn bằng cách bỏ qua, di chuyển hoặc lặp lại danh sách mẫu. ExoPlayer hỗ trợ một phần cho việc áp dụng danh sách chỉnh sửa. Ví dụ: trình phát có thể trì hoãn hoặc lặp lại các nhóm mẫu bắt đầu trên một mẫu đồng bộ hoá, nhưng không cắt bớt mẫu âm thanh hoặc nội dung nghe nhìn trước khi phát cho các nội dung chỉnh sửa không bắt đầu trên một mẫu đồng bộ hoá.
Nếu bạn thấy một phần của nội dung nghe nhìn bị thiếu hoặc lặp lại ngoài dự kiến, hãy thử đặt Mp4Extractor.FLAG_WORKAROUND_IGNORE_EDIT_LISTS hoặc FragmentedMp4Extractor.FLAG_WORKAROUND_IGNORE_EDIT_LISTS. Thao tác này sẽ khiến trình trích xuất bỏ qua hoàn toàn danh sách chỉnh sửa. Bạn có thể đặt các giá trị này trên DefaultExtractorsFactory bằng cách sử dụng setMp4ExtractorFlags hoặc setFragmentedMp4ExtractorFlags.
Tại sao một số luồng không thành công với mã phản hồi HTTP 301 hoặc 302?
Mã phản hồi HTTP 301 và 302 đều cho biết có hoạt động chuyển hướng. Bạn có thể xem nội dung mô tả ngắn gọn trên Wikipedia. Khi ExoPlayer đưa ra yêu cầu và nhận được phản hồi có mã trạng thái 301 hoặc 302, trình phát này thường sẽ tuân theo lệnh chuyển hướng và bắt đầu phát như bình thường. Trường hợp duy nhất mà điều này không xảy ra theo mặc định là đối với các lệnh chuyển hướng trên nhiều giao thức. Lệnh chuyển hướng trên nhiều giao thức là lệnh chuyển hướng từ HTTPS sang HTTP hoặc ngược lại (hoặc ít phổ biến hơn là giữa một cặp giao thức khác). Bạn có thể kiểm tra xem một URL có gây ra lệnh chuyển hướng giữa các giao thức hay không bằng cách sử dụng công cụ dòng lệnh wget như sau:
wget "https://yourserver.example.com/test.mp3" 2>&1 | grep Location
Kết quả đầu ra sẽ có dạng như sau:
Location: https://secondserver.example.net/test.mp3 [following]
Location: http://thirdserver.example.org/test.mp3 [following]
Trong ví dụ này, có hai lệnh chuyển hướng. Lệnh chuyển hướng đầu tiên là từ
https://yourserver.example.com/test.mp3 đến
https://secondserver.example.net/test.mp3. Cả hai đều là HTTPS, nên đây không phải là lệnh chuyển hướng giữa các giao thức. Lệnh chuyển hướng thứ hai là từ
https://secondserver.example.net/test.mp3 đến
http://thirdserver.example.org/test.mp3. Đây là lệnh chuyển hướng từ HTTPS sang HTTP,
vì vậy, đây là lệnh chuyển hướng trên nhiều giao thức. ExoPlayer sẽ không tuân theo lệnh chuyển hướng này trong cấu hình mặc định, nghĩa là quá trình phát sẽ không thành công.
Nếu cần, bạn có thể định cấu hình ExoPlayer để tuân theo lệnh chuyển hướng giữa các giao thức khi tạo thực thể DefaultHttpDataSource.Factory được dùng trong ứng dụng của bạn. Tìm hiểu về cách chọn và định cấu hình bộ phần cứng và phần mềm mạng tại đây.
Tại sao một số luồng không thành công và gặp lỗi UnrecognizedInputFormatException?
Câu hỏi này liên quan đến lỗi phát ở dạng sau:
UnrecognizedInputFormatException: None of the available extractors
(MatroskaExtractor, FragmentedMp4Extractor, ...) could read the stream.
Có hai nguyên nhân có thể gây ra lỗi này. Nguyên nhân phổ biến nhất là bạn đang cố gắng phát nội dung DASH (mpd), HLS (m3u8) hoặc SmoothStreaming (ism, isml), nhưng trình phát lại cố gắng phát nội dung đó dưới dạng luồng tăng dần. Để phát các luồng như vậy, bạn phải phụ thuộc vào mô-đun ExoPlayer tương ứng. Trong trường hợp URI của luồng không kết thúc bằng đuôi tệp chuẩn, bạn cũng có thể truyền MimeTypes.APPLICATION_MPD, MimeTypes.APPLICATION_M3U8 hoặc MimeTypes.APPLICATION_SS đến setMimeType của MediaItem.Builder để chỉ định rõ loại luồng.
Nguyên nhân thứ hai (ít phổ biến hơn) là ExoPlayer không hỗ trợ định dạng vùng chứa của nội dung nghe nhìn mà bạn đang cố phát. Trong trường hợp này, lỗi xảy ra là đúng như dự kiến. Tuy nhiên, bạn có thể gửi yêu cầu về tính năng đến Trình theo dõi sự cố của chúng tôi, bao gồm cả thông tin chi tiết về định dạng vùng chứa và luồng kiểm thử. Vui lòng tìm kiếm yêu cầu về tính năng hiện có trước khi gửi yêu cầu mới.
Tại sao setPlaybackParameters không hoạt động đúng cách trên một số thiết bị?
Khi chạy bản gỡ lỗi của ứng dụng trên Android M trở xuống, bạn có thể gặp phải tình trạng hiệu suất không ổn định, âm thanh bị lỗi và mức sử dụng CPU cao khi dùng API setPlaybackParameters. Điều này là do một tính năng tối ưu hoá quan trọng đối với API này bị tắt đối với các bản gỡ lỗi chạy trên những phiên bản Android này.
Điều quan trọng cần lưu ý là vấn đề này chỉ ảnh hưởng đến bản gỡ lỗi. Cờ này không ảnh hưởng đến các bản phát hành vì tính năng tối ưu hoá luôn được bật cho các bản phát hành. Do đó, các bản phát hành mà bạn cung cấp cho người dùng cuối sẽ không bị ảnh hưởng bởi vấn đề này.
Lỗi "Trình phát được truy cập trên luồng không chính xác" có nghĩa là gì?
Xem phần Lưu ý về luồng trên trang bắt đầu.
Làm cách nào để khắc phục lỗi "Dòng trạng thái không mong muốn: ICY 200 OK"?
Vấn đề này có thể xảy ra nếu phản hồi của máy chủ bao gồm một dòng trạng thái ICY, thay vì một dòng tuân thủ HTTP. Dòng trạng thái ICY không còn được dùng nữa và không nên sử dụng. Vì vậy, nếu kiểm soát máy chủ, bạn nên cập nhật máy chủ để cung cấp phản hồi tuân thủ HTTP. Nếu bạn không thể làm việc này, thì việc sử dụng thư viện ExoPlayer OkHttp sẽ giải quyết được vấn đề, vì thư viện này có thể xử lý chính xác các dòng trạng thái ICY.
Làm cách nào để truy vấn xem luồng đang phát có phải là sự kiện phát trực tiếp hay không?
Bạn có thể truy vấn phương thức isCurrentWindowLive của trình phát. Ngoài ra, bạn có thể kiểm tra isCurrentWindowDynamic để tìm hiểu xem cửa sổ có linh động hay không (tức là vẫn cập nhật theo thời gian).
Làm cách nào để tiếp tục phát âm thanh khi ứng dụng của tôi chạy trong nền?
Hãy làm theo các bước sau để đảm bảo âm thanh tiếp tục phát khi ứng dụng của bạn ở chế độ nền:
- Bạn cần có một dịch vụ nền trước đang chạy. Điều này giúp hệ thống không tắt quy trình của bạn để giải phóng tài nguyên.
- Bạn cần có
WifiLockvàWakeLock. Các quyền này đảm bảo rằng hệ thống luôn bật Wi-Fi và CPU. Bạn có thể dễ dàng thực hiện việc này nếu sử dụngExoPlayerbằng cách gọisetWakeMode. Thao tác này sẽ tự động lấy và giải phóng các khoá cần thiết vào đúng thời điểm.
Bạn cần phải nhả khoá (nếu không sử dụng setWakeMode) và dừng dịch vụ ngay khi âm thanh không còn phát nữa.
Tại sao ExoPlayer hỗ trợ nội dung của tôi nhưng thư viện ExoPlayer Cast thì không?
Có thể nội dung bạn đang cố phát không được bật CORS. Khung truyền yêu cầu nội dung phải được bật CORS để phát.
Tại sao nội dung không phát được nhưng không có lỗi nào xuất hiện?
Có thể thiết bị mà bạn đang phát nội dung không hỗ trợ một định dạng mẫu nội dung nghe nhìn cụ thể. Bạn có thể dễ dàng xác nhận điều này bằng cách thêm EventLogger làm trình nghe vào trình phát và tìm một dòng tương tự như dòng này trong Logcat:
[ ] Track:x, id=x, mimeType=mime/type, ... , supported=NO_UNSUPPORTED_TYPE
NO_UNSUPPORTED_TYPE có nghĩa là thiết bị không thể giải mã định dạng mẫu nội dung nghe nhìn do mimeType chỉ định. Hãy xem tài liệu về định dạng nội dung nghe nhìn trên Android để biết thông tin về các định dạng mẫu được hỗ trợ. Làm cách nào để tải thư viện giải mã và sử dụng thư viện đó để phát? cũng có thể hữu ích.
Làm cách nào để tải thư viện giải mã và sử dụng thư viện đó để phát?
- Hầu hết các thư viện bộ giải mã đều có các bước thủ công để kiểm tra và tạo phần phụ thuộc, vì vậy, hãy đảm bảo bạn đã làm theo các bước trong tệp README cho thư viện có liên quan. Ví dụ: đối với thư viện ExoPlayer FFmpeg, bạn cần làm theo hướng dẫn trong libraries/decoder_ffmpeg/README.md, bao gồm cả việc truyền cờ cấu hình để bật bộ giải mã cho mọi định dạng bạn muốn phát.
- Đối với các thư viện có mã gốc, hãy đảm bảo bạn đang sử dụng đúng phiên bản Android NDK như được chỉ định trong README và chú ý đến mọi lỗi xuất hiện trong quá trình định cấu hình và xây dựng. Bạn sẽ thấy các tệp
.soxuất hiện trong thư mục conlibscủa đường dẫn thư viện cho từng cấu trúc được hỗ trợ sau khi làm theo các bước trong README. - Để thử phát bằng thư viện trong ứng dụng minh hoạ, hãy xem phần bật bộ giải mã đi kèm. Hãy xem tệp README của thư viện để biết hướng dẫn về cách sử dụng thư viện trong ứng dụng của bạn.
- Nếu đang sử dụng
DefaultRenderersFactory, bạn sẽ thấy một dòng nhật ký cấp thông tin như "Loaded FfmpegAudioRenderer" (Đã tải FfmpegAudioRenderer) trong Logcat khi bộ giải mã tải. Nếu thiếu, hãy đảm bảo ứng dụng có phần phụ thuộc vào thư viện giải mã. - Nếu bạn thấy nhật ký cấp cảnh báo từ
LibraryLoadertrong Logcat, thì điều này cho biết rằng việc tải thành phần gốc của thư viện không thành công. Nếu điều này xảy ra, hãy kiểm tra xem bạn đã làm đúng các bước trong tệp README của thư viện hay chưa và không có lỗi nào xuất hiện trong khi làm theo hướng dẫn.
Nếu bạn vẫn gặp vấn đề khi sử dụng thư viện giải mã, vui lòng kiểm tra trình theo dõi sự cố của Media3 để xem có vấn đề nào liên quan gần đây hay không. Nếu bạn cần báo cáo một vấn đề mới và vấn đề đó liên quan đến việc xây dựng phần gốc của thư viện, vui lòng cung cấp toàn bộ kết quả dòng lệnh khi chạy hướng dẫn trong tệp README để giúp chúng tôi chẩn đoán vấn đề.
Tôi có thể phát video trên YouTube trực tiếp bằng ExoPlayer không?
Không, ExoPlayer không thể phát video trên YouTube, chẳng hạn như URL của biểu mẫu https://www.youtube.com/watch?v=.... Thay vào đó, bạn nên sử dụng YouTube IFrame Player API, đây là cách chính thức để phát video trên YouTube trên Android.
Video phát bị giật
Thiết bị có thể không giải mã được nội dung đủ nhanh nếu, ví dụ: tốc độ bit hoặc độ phân giải nội dung vượt quá khả năng của thiết bị. Bạn có thể cần sử dụng nội dung có chất lượng thấp hơn để đạt được hiệu suất tốt trên các thiết bị như vậy.
Nếu bạn gặp phải tình trạng giật video trên thiết bị chạy phiên bản Android từ Android 6.0 (cấp độ API 23) đến Android 11 (cấp độ API 30), đặc biệt là khi phát nội dung được bảo vệ bằng DRM hoặc nội dung có tốc độ khung hình cao, bạn có thể thử bật tính năng xếp hàng đợi bộ đệm không đồng bộ.
Lỗi tìm mã nguồn API không ổn định
Media3 đảm bảo khả năng tương thích nhị phân cho một nhóm nhỏ của nền tảng API. Các phần không đảm bảo khả năng tương thích nhị phân được đánh dấu bằng @UnstableApi. Để làm rõ sự khác biệt này, việc sử dụng các ký hiệu API không ổn định sẽ tạo ra lỗi tìm mã nguồn trừ phi các ký hiệu đó được chú thích bằng @OptIn.
Chú thích @UnstableApi không ngụ ý gì về chất lượng hoặc hiệu suất của một API, mà chỉ cho biết rằng API đó không bị "đóng băng".
Bạn có hai lựa chọn để xử lý lỗi tìm mã nguồn API không ổn định:
- Chuyển sang sử dụng một API ổn định để đạt được kết quả tương tự.
- Tiếp tục sử dụng API không ổn định và chú thích cách sử dụng bằng
@OptIn, như minh hoạ ở phần sau.
Thêm chú thích @OptIn
Android Studio có thể giúp bạn thêm chú thích:
Bạn cũng có thể chú thích theo cách thủ công cho các trang web sử dụng cụ thể:
Kotlin
import androidx.annotation.OptIn
import androidx.media3.common.util.UnstableApi
@OptIn(UnstableApi::class)
fun functionUsingUnstableApi() { ... }
Java
import androidx.annotation.OptIn;
import androidx.media3.common.util.UnstableApi;
@OptIn(markerClass = UnstableApi.class)
private void methodUsingUnstableApis() { ... }
Bạn có thể chọn sử dụng toàn bộ gói bằng cách thêm tệp package-info:
Kotlin
// In your package-info.kt
@OptIn(UnstableApi::class)
package name.of.your.package
import androidx.annotation.OptIn
import androidx.media3.common.util.UnstableApi
Java
// In your package-info.java
@OptIn(markerClass = UnstableApi.class)
package name.of.your.package;
import androidx.annotation.OptIn;
import androidx.media3.common.util.UnstableApi;
Bạn có thể chọn sử dụng toàn bộ dự án bằng cách loại bỏ lỗi tìm mã nguồn cụ thể trong
tệp lint.xml:
<?xml version="1.0" encoding="utf-8"?>
<lint>
<issue id="UnsafeOptInUsageError">
<option name="opt-in" value="androidx.media3.common.util.UnstableApi" />
</issue>
</lint>
Ngoài ra, bạn không nên sử dụng chú thích kotlin.OptIn. Bạn cần phải sử dụng chú thích androidx.annotation.OptIn.
Làm cách nào để thử nghiệm hoặc tách biệt các vấn đề do tính năng hoặc hoạt động tối ưu hoá mới gây ra?
Media3 bao gồm cơ sở hạ tầng cờ tính năng, trong đó các tính năng và hoạt động tối ưu hoá mới được bật theo mặc định ở chế độ Canary.
Nếu nghi ngờ rằng một vấn đề hoặc sự hồi quy trong ứng dụng của bạn có liên quan đến một tính năng hoặc hoạt động tối ưu hoá mới được giới thiệu, bạn có thể tạm thời tắt chế độ Canary:
Flags.setCanaryModeEnabled(false);
Hoặc tắt từng cờ tính năng cụ thể bằng cách sử dụng Flags.disableFlag(flagId). Để biết thêm thông tin chi tiết về cách định cấu hình chế độ Canary, ghi đè cờ và thiết lập công tắc tắt từ xa, hãy xem Hướng dẫn về cờ tính năng và chế độ Canary.