Sử dụng ứng dụng kiểm tra trình điều khiển nội dung nghe nhìn

Ứ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 Android, ô tô, TV và tai nghe được API phiên nội dung nghe nhìn của Android hỗ trợ và sử dụng các thao tác đối với nội dung đa phương tiện. Vòng đời hành động đối với nội dung đa phương tiện có thể khó theo dõi. Thậm chí chỉ là một lượt phát đơn giản trên Tìm kiếm yêu cầu có nhiều bước trung gian mà có thể xảy ra lỗi, như minh hoạ trong tiến trình đơn giản:

Vòng đời hành động đối với nội dung đa phương tiện

Hình 1. Vòng đời hành động đối với nội dung đa phương tiện

Kiểm thử trình điều khiển nội dung nghe nhìn (MCT) cho phép bạn kiểm tra chi tiết khi phát nội dung nghe nhìn trên Android và giúp xác minh cách triển khai phiên đa phương tiện của bạn.

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. Bạn có thể dùng để kiểm thử các chế độ điều khiển nội dung nghe nhìn trong ứng dụng. MCT cũng bao gồm quy trình kiểm tra xác minh khung đó cho phép bạn tự động hoá quy trình kiểm thử đảm bảo chất lượng.

Để sử dụng MCT, ứng dụng của bạn phải có dịch vụ trình duyệt nội dung đa phương tiện và bạn phải cho phép MCT kết nối với nó. Xem Xây dựng dịch vụ trình duyệt nội dung đa phương tiện để biết thêm thông tin.

Bắt đầu MCT

Trang ra mắt MCT
Hình 2. Trang ra mắt của MCT

Khi chạy MCT, bạn sẽ thấy hai danh sách:

  • Active MediaSessions – Danh sách này ban đầu trống khi bạn khởi chạy MCT và bạn sẽ thấy thông báo "Không tìm thấy ứng dụng đa phương tiện nào. Thông báo Cần có quyền của người nghe để 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 rồi cấp quyền cho MCT.
  • Hoạt động triển khai MediaBrowserService – Danh sách này cho biết các ứng dụng đã triển khai dịch vụ trình duyệt nội dung đa phương tiện. Nếu bạn đã triển khai dịch vụ trình duyệt nội dung đa phương tiện, ứ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ả hoặc đưa MCT vào danh sách cho phép. Xem phần Kiểm soát kết nối ứ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ụ trình duyệt nội dung đa phương tiệ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 danh sách dịch vụ trình duyệt nội dung đa phương tiện. Tìm thông tin này ở đó rồi nhấp vào Control để 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 ở chế độ nền, sau đó nhấp vào Kiểm soát khi thiết bị này 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 bắt đầu kiểm soát ứng dụng của bạn, MCT sẽ cho thấy phiên hoạt động hiện tại của ứng dụng siêu dữ liệu: phương tiện hiện được chọn và hành động trong phiên sẵn sàng xử lý.

Trang điều khiển
Hình 3. Trang điều khiển

Phần đầu trang điều khiển MCT chứa 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 được liên kết với Tìm kiếm, URI hoặc ID phương tiện nếu bạn hãy chọn một trong các tuỳ chọn đó.

Các nút Chuẩn bịPhát ngay bên dưới trường văn bản sẽ thực hiện cuộc 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.

Đang kiểm tra quyền phát âm thanh

Một ứng dụng đa phương tiện hoạt động tốt có thể xử lý âm thanh tập trung. Bạn có thể kiểm tra 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 bao gồm để yêu cầu và thả quyền phát âm thanh.

Để kiểm tra quyền phát âm thanh, hãy làm theo các bước sau:

  1. Sử dụng trình đơn thả xuống Audio Focus (Tập trung vào âm thanh) để chọn một trong 3 gợi ý về thời lượng AUDIOFOCUS_GAIN, AUDIOFOCUS_GAIN_TRANSIENT hoặc AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK.
  2. Nhấn nút này để yêu cầu lấy tiêu điểm.
  3. Nhấn lại nút này để thả tiêu điểm.

Kiểm thử các phương thức điều khiển truyền tải

Kiểm thử các chế độ điều khiển truyền tải
Hình 4. Kiểm thử các chế độ kiểm soát truyền tải

Vuốt sang trái để hiện thành phần hiển thị giao diện người dùng của MCT. Chế độ xem này có các nút truyền tải của trình điều khiển nội dung nghe nhìn chuẩn và hiển thị dữ liệu và hình ảnh chương trình. Các nút di chuyển bị tắt được khoanh tròn màu cam. Tất cả các nguồn khác đều đang hoạt động.

Kiểm thử trình phát bằng các nút di chuyển. Trạng thái của các nút truyền tải sẽ thay đổi như dự kiến. Ví dụ: khi bạn nhấn nút PHÁT, tắt, đồng thời nút TẠM DỪNG và DỪNG sẽ 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ó chế độ kiểm soát cho biết chế độ đó có đang hoạt động hay không. Nếu trạng thái đang hoạt động, bạn có thể thực hiện hành động bằng cách nhấp vào nó.

Nếu đã kết nối từ danh sách ứng dụng có dịch vụ trình duyệt nội dung nghe nhìn, bạn có thể vuốt sang trái hai lần nữa để xem các chế độ xem cho phép bạn di chuyển lên và xuống 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ử tay đ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ổ rồi mở MCT ở chế độ chia đôi màn hình.

Chạy kiểm thử xác minh

Khung kiểm thử xác minh cung cấp các quy trình kiểm thử bằng một lần nhấp mà bạn có thể chạy đảm bảo rằng ứ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

Nút Kiểm tra
Hình 5. Nút thử nghiệm

Để truy cập các bài kiểm thử xác minh, hãy nhấp vào nút Kiểm tra bên cạnh nội dung nghe nhìn .

Trạng thái MCT

Trạng thái điều khiển nội dung nghe nhìn
Hình 6. Trạng thái điều khiển nội dung nghe nhìn

Chế độ xem tiếp theo hiển thị cho bạn 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 ở trên cùng bên phải thanh công cụ. Nút ở bên trái chuyển đổi giữa chế độ phân tích cú pháp và định dạng nhật ký. Nút ở bên phải làm mới chế độ xem để hiển thị thông tin mới nhất.

Chọn thử nghiệm

Trang lựa chọn thử nghiệm
Hình 7. Trang lựa chọn thử nghiệm

Bằng cách vuốt sang trái, bạn sẽ được chuyển đến chế độ xem các bài kiểm thử xác minh. Tại đây, bạn có thể xem một danh sách có thể cuộn gồm các bài kiểm thử có sẵn. Nếu kiểm thử sử dụng một truy vấn, chẳng hạn như thử nghiệm tìm kiếm được minh hoạ trong Hình 7, có trường văn bản để nhập chuỗi truy vấn.

MCT bao gồm các thử nghiệm cho các hành động với nội dung đ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 trên trang Tìm kiếm
  • Phát từ mã nhận dạng nội dung đa phương tiện
  • Phát từ URI
  • Tạm dừng
  • Dừng
  • Chuyển đến mục tiếp theo
  • Chuyển về mục trước
  • Chuyển đến mục trong danh sách chờ
  • Tua đến

Kết quả thử nghiệm

Kết quả xét nghiệm thành công
Hình 8. Kết quả xét nghiệm thành công

Ban đầu, khu vực kết quả ở dưới cùng chế độ xem sẽ trống. Thao tác này sẽ hiển thị khi chạy thử nghiệm. Ví dụ: để chạy phát từ bài kiểm tra tìm kiếm, 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 kiểm thử). Nội dung sau đây ảnh chụp màn hình cho thấy kết quả kiểm tra thành công.

Kiểm thử ứng dụng trên Android TV

Khi chạy MCT trên Android TV, bạn sẽ thấy một danh sách các ứng dụng đa phương tiện đã cài đặt. 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 trình duyệt nội dung đa phương tiện .

Trang giới thiệu MCT trên TV

Hình 9. Trang giới thiệu MCT trên TV

Thao tác chọn một ứng dụng sẽ đưa bạ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.

Trang Kiểm tra quy trình xác minh trên TV

Hình 10. Trang Kiểm tra quy trình xác minh trên TV

Khi bạn chạy bài 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 chi tiết, hãy kiểm tra nhật ký MCT trong Logcat.

Trang thông tin xét nghiệm trên TV

Hình 11. Trang thông tin xét nghiệm trên TV

Những bài kiểm thử yêu cầu truy vấn được đánh dấu bằng biểu tượng bàn phím. Nhấp vào một trong các phép kiểm thử này mở ra 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ụ: như sau sẽ thêm văn bản "hello world" (xin chào mọi người) vào trường nhập dữ liệu.

adb shell input text hello%sworld

Xây dựng thử nghiệm

Bạn có thể gửi yêu cầu lấy dữ liệu (pull request) với nhiều bài kiểm thử hơn mà bạn cho là hữu ích. Để tìm hiểu cách tạo thử nghiệm mới, hãy truy cập vào Trang Wiki của MCT GitHub và xem kiểm tra xác minh hướng dẫn.

Vui lòng xem hướng dẫn đóng góp.

Tài nguyên khác

MCT được dùng cùng với các ứng dụng triển khai API nội dung đa phương tiện. Xem Trình phát nhạc Universal Android để xem 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.