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

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 API phiên phát nội dung đa phương tiện của Android hỗ trợ và sử dụng các thao tác 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. Ngay cả một lượt phát đơn giản từ yêu cầu tìm kiếm cũng có nhiều bước trung gian có thể xảy ra sự cố, như thể hiện trong tiến trình được đơn giản hoá:

Vòng đời thao tác đối với nội dung đa phương tiện

Hình 1. Vòng đời thao tác đối với nội dung đa phương tiện

Ứ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.

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ể được dùng để kiểm thử các chế độ đ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.

Để 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 dịch vụ đó. Xem bài viết 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.

Khởi động MCT

Trang ra mắt MCT
Hình 2. Trang ra mắt 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 chạy MCT và bạn sẽ thấy thông báo "No đa phương tiện không tìm thấy ứng dụng đa phương tiện nào ". Cần có quyền Trình nghe thông báo để quét tìm các phiên 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 bật quyền cho MCT.
  • 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 nghe nhìn. Nếu đã triển khai dịch vụ trình duyệt nội dung đa phương tiệ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ể dùng MCT nếu đã định cấu hình ứng dụng để chấp nhận tất cả kết nối hoặc MCT vào danh sách cho phép. Vui lòng xem bài viết Kiểm soát các kết nối của ứng dụng bằng onGetRoot() để biết thêm thông tin.

Kiểm thử thủ công ứng dụng điện thoại

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. Hãy tìm mã này tại đó rồi nhấp vào Control (Kiểm soát) để khởi động ứng dụng của bạn ở chế độ 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 Control khi ứng dụng 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.

Chuẩn bị và chơi thử nghiệm

Khi bắt đầu kiểm soát ứng dụng của bạn, MCT sẽ hiển thị siêu dữ liệu về phiên hiện tại của ứng dụng: nội dung nghe nhìn đang chọn và những thao tác mà phiên đó được chuẩn bị để xử lý.

Trang kiểm soát
Hình 3. Trang kiểm soát

Phần đầu của trang điều khiển MCT chứa trình đơn thả xuống để bạn có thể chọn Search (Tìm kiếm), URI, Media ID (Tìm kiếm) hoặc None (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 Mã nhận dạng nội dung đa phương tiện nếu bạn chọn một trong những tuỳ chọn đó.

Các nút Chuẩn bịPhát ngay bên dưới trường văn bản 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 thao tác 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 phải có thể 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 song song với ứng dụng của mình. Trang điều khiển MCT có một nút yêu cầu và phát hành 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 ba 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 nét.
  3. Nhấn nút lần nữa để nhả tiêu điểm.

Kiểm thử các chế độ điều khiển truyền tải

Kiểm thử bộ điều khiển truyền tải
Hình 4. Kiểm thử bộ điều khiển truyền tải

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

Kiểm thử trình phát bằng các nút truyền tải. 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 PLAY, nút này sẽ bị tắt, đồng thời các nút PAUSE và DỪNG sẽ bật.

Vuốt sang trái một lần nữa để xem màn hình các hành động không bắt buộc. Mỗi thao tác đều có một tuỳ chọn kiểm soát cho biết thao tác đó có đang hoạt động hay không. Nếu mã này đang hoạt động, bạn có thể thực hiện thao tác 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 2 lần nữa để xem các khung hiển thị 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ử bộ điều khiển của ứ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 chương 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 một yêu cầu phát.

Kiểm thử ứng dụng điện thoại

Nút Thử nghiệm
Hình 5. Nút Thử nghiệm

Để 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.

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, chẳng hạn như PlaybackState, siêu dữ liệu và hàng đợi. Có 2 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 sẽ 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 kiểm thử xác minh. Tại đây, bạn có thể xem danh sách cuộn được các kiểm thử hiện có. Nếu quy trình kiểm thử sử dụng một cụm từ tìm kiếm, chẳng hạn như lượt phát từ kiểm thử tìm kiếm như 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 bài kiểm thử cho các hành động đa phương tiện sau đây, và nhiều bài kiểm thử khác được liên tục thêm vào dự án:

  • Phát
  • Phát trên 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 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

Kết quả kiểm tra thành công
Hình 8. Kết quả kiểm tra thành công

Ban đầu, khu vực kết quả ở cuối chế độ xem trống. Chiến dịch này sẽ hiện kết quả khi bạn chạy kiểm thử. Ví dụ: để chạy lượt phát từ kiểm thử tìm kiếm, hãy nhập 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ử). Ảnh chụp màn hình sau đây cho thấy một kết quả kiểm thử 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 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 đa phương tiện.

Trang ra mắt MCT trên TV

Hình 9. Trang ra mắt MCT trên TV

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 kiểm thử xác minh ở bên phải.

Trang kiểm tra việc xác minh trên TV

Hình 10. Trang kiểm tra việc xác minh trên TV

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 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

Các chương trình kiểm thử yêu cầu truy vấn được đánh dấu bằng biểu tượng bàn phím. Khi bạn nhấp vào một trong các lượt kiểm thử này, một trường nhập dữ liệu sẽ mở ra 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ể sử 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 "xin chào thế giới" vào trường nhập dữ liệu.

adb shell input text hello%sworld

Xây dựng bài kiểm thử

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

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

Tài nguyên khác

MCT được thiết kế để sử dụng cùng với các ứng dụng triển khai API đa phương tiện. Hãy xem Universal Android Music Player để biết ví dụ về ứ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.