Phát triển cho TV

Để trò chơi hoạt động chính xác trên nền tảng truyền hình, trò chơi phải đáp ứng các yêu cầu sau:

• Trò chơi chiếm toàn bộ khu vực màn hình và hỗ trợ chế độ toàn màn hình.
• Trò chơi hỗ trợ các chức năng điều khiển và điều hướng giữa các phần tử tương tác thông qua các nút mũi tên trên điều khiển từ xa của TV.
• Trò chơi hỗ trợ các nút Quay lại và OK trên điều khiển từ xa của TV.
• Ứng dụng không có mua hàng trong trò chơi.
• Trong trò chơi không có liên kết đến các ứng dụng khác của nhà phát triển.

Xử lý các sự kiện nút mũi tên và OK

Các nút trên điều khiển từ xa phải hoạt động hoàn toàn trong trò chơi và trong các phần sau:

• Menu chính trước khi vào trò chơi (nếu có). Ví dụ: người dùng phải có thể nhấn OK trên điều khiển từ xa để bắt đầu trò chơi hoặc chọn cấp độ thông qua các nút mũi tên.
• Menu trong trò chơi được mở bằng nút Quay lại.

Điều khiển từ xa sẽ gửi một sự kiện tại một thời điểm. Nếu trò chơi của bạn có cơ chế yêu cầu nhấn nhiều phím cùng một lúc, một số hành động, chẳng hạn như nhảy hoặc chuyển động về phía trước, có thể được thực hiện tự động.

Để biết mô tả về các sự kiện nhấn nút trên điều khiển từ xa, hãy xem Tài liệu KeyboardEvent. Các nút trên điều khiển từ xa được gán các giá trị sự kiện cụ thể:

• Mũi tên: ArrowLeft, ArrowUp, ArrowRight, ArrowDown.
• OK: Enter.

Nếu bạn sử dụng một công cụ trò chơi hỗ trợ tay cầm chơi game (Unity, Construct, Defold), khi đó trò chơi sẽ nhận dạng điều khiển từ xa của TV là tay cầm chơi game. Trong trường hợp này, hãy làm theo tài liệu hiện hành về tay cầm chơi game để đặt cấu hình cách xử lý các sự kiện nút mũi tên và OK.

Xử lý các sự kiện nút Quay lại

Tất cả các điều khiển từ xa cho TV hỗ trợ TV thông minh đều có nút Quay lại.

Dưới đây là các sự kiện chính liên quan đến nút Quay lại trong khi chơi game:

• Nhấn nút trong menu chính sẽ kích hoạt cửa sổ xác nhận để thoát trò chơi.
• Nhấn nút trong khi chơi game sẽ tạm dừng trò chơi và mở menu trò chơi.
• Nhấn nút hai lần trong khi chơi game sẽ kích hoạt cửa sổ xác nhận để thoát trò chơi.

Để biết mô tả chi tiết về các sự kiện, hãy xem Sự kiện.

Tương tác với Yandex Games SDK

Sau khi Yandex Games SDK được khởi tạo, đối tượng deviceInfo sẽ trả về loại thiết bị của người dùng trong trường type.

Khi khởi chạy một trò chơi trên TV, một chuỗi có giá trị tv sẽ được trả lại cho trường type. Sau đó, trò chơi đã sẵn sàng xử lý thông tin đầu vào từ điều khiển từ xa. Cũng có thể truyền văn bản, hướng dẫn và các tài liệu khác cần thiết cho việc chơi game.

Để biết thêm thông tin về đối tượng deviceInfo và các phương thức của đối tượng, hãy xem Các đối tượng và tham số SDK khác.

Thêm trò chơi

Khi đã thực hiện khả năng hỗ trợ cho các nút điều khiển từ xa của TV, bạn có thể thêm trò chơi của mình vào danh mục Yandex Games. Khi điền vào bản nháp trò chơi của bạn trong Bảng điều khiển Yandex Games, hãy chọn TV từ danh sách các nền tảng được hỗ trợ.

Nếu trò chơi qua được bước kiểm duyệt, trò chơi sẽ được bao gồm trong một gói cài đặt TV đặc biệt và được cung cấp cho người dùng TV.

Kiểm thử trò chơi

Bạn có thể kiểm thử trò chơi bằng cách mở bản nháp của trò chơi trên TV hỗ trợ cửa hàng Yandex TV:

1. Mở ứng dụng Yandex Games và chờ trang bắt đầu tải.

2. Nhấn các phím sau trên điều khiển từ xa: ← ↑ ← ↑ ← ↑ ← ↑. Màn hình vào chức năng sẽ mở ra.

   Ghi chú

   Trình tự này sẽ hoạt động nếu bạn đã chọn ô trên cùng bên trái trong giao diện trang bắt đầu.

3. Nhập ID trò chơi.