Các ứng dụng đa phương tiện tương tác bằng giọng nói với Trợ lý Google trên điện thoại, ô tô, TV và tai nghe Android được hỗ trợ bởi API phiên phát nội dung nghe nhìn của Android và sử dụng các thao tác đa phương tiện. Vòng đời của hành động đa phương tiện có thể khó theo dõi. Ngay cả một yêu cầu phát đơn giản từ tìm kiếm cũng có nhiều bước trung gian có thể xảy ra lỗi, như trong dòng thời gian đơn giản sau:
Ứng dụng Kiểm thử trình điều khiển nội dung nghe nhìn (MCT) cho phép bạn kiểm thử chi tiết nội dung nghe nhìn phát trên Android và giúp xác minh cách triển khai phiên nội dung nghe nhìn của bạn.
Ứng dụng Kiểm thử trình điều khiển nội dung nghe nhìn có hai phiên bản:
- Ứng dụng khách được triển khai dựa trên
MediaControllerCompatcũ. Điều này cho phép kiểm thử ứng dụng phiên phát nội dung nghe nhìn được xây dựng dựa trênMediaSessionCompatcũ hoặcMediaSessionMedia3 khi được một ứng dụng bên ngoài truy cập thông quaMediaControllerCompatcũ. Tìm mã nguồn của phiên bản cũ trên GitHub. - Ứng dụng khách được triển khai dựa trên Media3 mới nhất
MediaController. Điều này cho phép kiểm thử ứng dụng phiên phát nội dung nghe nhìn được xây dựng dựa trênMediaSessionCompatcũ hoặc Media3MediaSessionkhi được truy cập bằng một ứng dụng bên ngoài thông qua Media3MediaController. Tìm mã nguồn của phiên bản Media3 trên GitHub.
MCT hiển thị thông tin về MediaController của ứng dụng, chẳng hạn như PlaybackState và siêu dữ liệu, đồng thời có thể dùng để kiểm thử các nút điều khiển nội dung nghe nhìn giữa các ứng dụng.
MCT cũng bao gồm một khung kiểm thử xác minh cho phép bạn tự động hoá quy trình kiểm thử đảm bảo chất lượng (QA).
Để sử dụng MCT, ứng dụng của bạn phải có dịch vụ trình duyệt nội dung nghe nhìn và bạn phải cho phép MCT kết nối với dịch vụ đó. Hãy xem bài viết Tạo dịch vụ trình duyệt đa phương tiện để biết thêm thông tin.
Bắt đầu MCT
Khi chạy MCT, bạn sẽ thấy hai danh sách:
- Active MediaSessions (MediaSessions đang hoạt động) – Danh sách này ban đầu sẽ trống khi bạn chạy MCT và bạn sẽ thấy thông báo "No media apps found " (Không tìm thấy ứng dụng đa phương tiện). Cần có quyền Trình nghe thông báo để quét tìm các phiên phát nội dung nghe nhìn đang hoạt động." Nhấp vào Cài đặt để chuyển đến màn hình quyền và bật quyền cho MCT.
- Triển khai MediaBrowserService – Danh sách này cho thấy những ứng dụng đã triển khai dịch vụ trình duyệt nội dung nghe nhìn. Nếu đã triển khai dịch vụ trình duyệt nội dung nghe nhìn, thì ứng dụng của bạn sẽ xuất hiện trong danh sách này, nhưng bạn chỉ có thể sử dụng MCT nếu đã định cấu hình ứng dụng để chấp nhận tất cả các kết nối hoặc đưa MCT vào danh sách cho phép. Hãy xem phần Kiểm soát kết nối của ứng dụng bằng onGetRoot() để biết thêm thông tin.
Kiểm thử ứng dụng điện thoại theo cách thủ công
Nếu bạn cho phép MCT kết nối với dịch vụ duyệt nội dung nghe nhìn của ứng dụng, thì ứng dụng của bạn sẽ xuất hiện trong danh sách triển khai dịch vụ duyệt nội dung nghe nhìn. Tìm ứng dụng đó rồi nhấp vào Điều khiển để khởi động ứng dụng trong nền.
Nếu không, trước tiên, bạn phải tự khởi động ứng dụng trong nền, sau đó nhấp vào Control (Điều khiển) khi ứng dụng xuất hiện trong danh sách các phiên phát nội dung nghe nhìn đang hoạt động.
Kiểm thử, chuẩn bị và chơi
Khi MCT bắt đầu kiểm soát ứng dụng, công cụ này sẽ hiển thị siêu dữ liệu phiên hiện tại của ứng dụng: nội dung nghe nhìn hiện được chọn và các hành động mà phiên đã chuẩn bị để xử lý.
Phần đầu trang điều khiển MCT có một trình đơn thả xuống, nơi bạn có thể chọn Tìm kiếm, URI, Mã nhận dạng nội dung đa phương tiện hoặc Không có, cùng với một trường văn bản để chỉ định dữ liệu đầu vào liên kết với Tìm kiếm, URI hoặc Mã nhận dạng nội dung đa phương tiện nếu bạn chọn một trong các lựa chọn đó.
Các nút Prepare (Chuẩn bị) và Play (Phát) ngay bên dưới trường văn bản sẽ thực hiện các lệnh gọi thích hợp (onPrepare(), onPrepareFromSearch(), onPrepareFromUri(), onPrepareFromMediaId(), onPlay(), onPlayFromSearch(), onPlayFromUri(), onPlayFromMediaId()) tuỳ thuộc vào hành động bạn đã chọn.
Kiểm thử quyền phát âm thanh
Một ứng dụng đa phương tiện hoạt động đúng cách phải có khả năng xử lý quyền phát âm thanh. Bạn có thể kiểm thử quyền phát âm thanh bằng cách chạy một ứng dụng âm thanh khác cùng với ứng dụng của bạn. Trang điều khiển MCT có một nút yêu cầu và giải phóng quyền phát âm thanh.
Để kiểm tra tiêu điểm âm thanh, hãy làm theo các bước sau:
- Sử dụng trình đơn thả xuống Audio Focus (Tiêu điểm âm thanh) để chọn một trong ba gợi ý về thời lượng
AUDIOFOCUS_GAIN,AUDIOFOCUS_GAIN_TRANSIENThoặcAUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK. - Nhấn nút để yêu cầu lấy tiêu điểm.
- Nhấn nút một lần nữa để bỏ tiêu điểm.
Kiểm thử các nút điều khiển phương tiện
Vuốt sang trái để hiển thị chế độ xem giao diện người dùng của MCT. Chế độ xem này có các nút điều khiển trình phát nội dung nghe nhìn tiêu chuẩn và cho thấy hình ảnh cũng như dữ liệu chương trình của phiên. Các nút điều khiển bị tắt được khoanh tròn bằng màu cam. Tất cả các tài khoản khác đều đang hoạt động.
Kiểm thử trình phát bằng các nút điều khiển. Trạng thái của các nút điều khiển sẽ thay đổi như mong đợi. Ví dụ: khi bạn nhấn nút PHÁT, nút này sẽ bị tắt và các nút TẠM DỪNG và DỪNG sẽ được bật.
Vuốt sang trái một lần nữa để xem các thao tác không bắt buộc. Mỗi hành động có một chế độ điều khiển cho biết hành động đó có đang hoạt động hay không. Nếu nút này đang hoạt động, bạn có thể thực hiện hành động bằng cách nhấp vào nút đó.
Nếu đã kết nối từ danh sách ứng dụng có dịch vụ trình duyệt nội dung đa phương tiện, bạn có thể vuốt sang trái thêm hai lần nữa để xem các chế độ xem cho phép bạn di chuyển lên và xuống hệ phân cấp nội dung của ứng dụng hoặc tìm kiếm cây nội dung.
Kiểm thử ứng dụng video theo cách thủ công
Sử dụng chế độ chia đôi màn hình để kiểm thử trình điều khiển ứng dụng video. Trước tiên, hãy mở ứng dụng video trong một cửa sổ, sau đó mở MCT ở chế độ chia đôi màn hình.
Đang chạy các chương trình kiểm thử xác minh
Khung kiểm thử xác minh cung cấp các bài kiểm thử bằng một lần nhấp mà bạn có thể chạy để đảm bảo ứng dụng đa phương tiện của bạn phản hồi chính xác yêu cầu phát.
Kiểm thử ứng dụng điện thoại
Để truy cập vào các bài kiểm thử xác minh, hãy nhấp vào nút Test (Kiểm thử) bên cạnh ứng dụng đa phương tiện của bạn.
Trạng thái MCT
Chế độ xem tiếp theo cho bạn biết thông tin chi tiết về MediaController của MCT,
ví dụ: PlaybackState, siêu dữ liệu và hàng đợi. Có hai nút ở
trên cùng bên phải của thanh công cụ. Nút bên trái chuyển đổi giữa nhật ký có thể phân tích cú pháp và nhật ký được định dạng. Nút ở bên phải làm mới chế độ xem để hiển thị thông tin mới nhất.
Chọn một chương trình kiểm thử
Bằng cách vuốt sang trái, bạn sẽ đến chế độ xem kiểm thử xác minh, nơi bạn có thể xem danh sách có thể cuộn gồm các kiểm thử hiện có. Nếu một chương trình kiểm thử sử dụng truy vấn, chẳng hạn như chương trình kiểm thử phát từ nội dung tìm kiếm trong Hình 7, thì sẽ có một trường văn bản để nhập chuỗi truy vấn.
MCT bao gồm các thử nghiệm cho những hành động đa phương tiện sau đây và nhiều thử nghiệm khác liên tục được thêm vào dự án:
- Phát
- Phát từ Tìm kiếm
- Phát từ mã nhận dạng nội dung nghe nhìn
- Phát từ URI
- Tạm dừng
- Dừng
- Chuyển tới mục tiếp theo
- Chuyển về mục trước
- Chuyển đến mục trong hàng đợi
- Tua đến
Kết quả thử nghiệm
Khu vực kết quả ở cuối chế độ xem ban đầu sẽ trống. Bảng điều khiển này sẽ cho thấy kết quả khi bạn chạy một chương trình kiểm thử. Ví dụ: để chạy thử nghiệm phát từ kết quả tìm kiếm, hãy nhập một cụm từ tìm kiếm vào trường văn bản rồi nhấp vào Run Test (Chạy thử nghiệm). Ảnh chụp màn hình sau đây cho thấy kết quả kiểm thử thành công.
Kiểm thử ứng dụng cho Android TV
Khi chạy MCT trên Android TV, bạn sẽ thấy danh sách các ứng dụng đa phương tiện đã cài đặt. Xin lưu ý rằng một ứng dụng sẽ chỉ xuất hiện trong danh sách này nếu ứng dụng đó triển khai dịch vụ trình duyệt nội dung nghe nhìn.
Khi chọn một ứng dụng, bạn sẽ được chuyển đến màn hình kiểm thử. Màn hình này hiển thị danh sách các bài kiểm thử xác minh ở bên phải.
Khi bạn chạy kiểm thử, phía bên trái màn hình sẽ hiển thị thông tin về MediaController đã chọn. Để biết thêm thông tin, hãy xem nhật ký MCT trong Logcat.
Các bài kiểm tra yêu cầu truy vấn được đánh dấu bằng biểu tượng bàn phím. Khi nhấp vào một trong các thử nghiệm này, bạn sẽ thấy một trường nhập dữ liệu cho truy vấn. Nhấp vào Enter để chạy kiểm thử.
Để nhập văn bản dễ dàng hơn, bạn cũng có thể sử dụng lệnh adb:
adb shell input text your-query
Bạn có thể dùng "%s" để thêm dấu cách giữa các từ. Ví dụ: lệnh sau đây sẽ thêm văn bản "hello world" vào trường nhập dữ liệu.
adb shell input text hello%sworld
Xây dựng chương trình kiểm thử
Bạn có thể gửi yêu cầu lấy dữ liệu kèm theo các bài kiểm thử khác mà bạn cho là hữu ích. Để tìm hiểu cách tạo các bài kiểm thử mới, hãy truy cập vào MCT GitHub Wiki và xem hướng dẫn kiểm thử xác minh.
Để biết thêm thông tin, hãy xem hướng dẫn đóng góp.
Tài nguyên khác
MCT được dùng kết hợp với các ứng dụng triển khai API nội dung nghe nhìn. Hãy xem Universal Android Music Player để biết ví dụ về một ứng dụng như vậy.
Chúng tôi luôn hoan nghênh các bản sửa lỗi và cải tiến. Vui lòng xem hướng dẫn đóng góp.