Bảng Debug

Bảng gỡ lỗi - đây là công cụ giúp bạn kiểm thử bản rasci: theo dõi cuộc gọi của SDK, mô phỏng kết nối Internet kém, loại bỏ trung tâm của trò chơi, tắt màn hình khởi động của Yandex vv.

Bật bảng gỡ lỗi

Bảng gỡ lỗi sẽ xuất hiện ở góc dưới bên trái của trang trò chơi.

Các phần của bảng gỡ lỗi

Bộ tải

Bộ tải có thể có các giá trị:

Chỉ số	Văn bản	Giá trị
W	—	Đang chờ khởi tạo.
IT	Is loader: true	SDK Loader đã được khởi tạo đúng cách.
IF	Is loader: false	Sử dụng Loader cũ. Hãy tải SDK theo tài liệu hướng dẫn (mục 1.19.1).

Chỉ báo Game Ready

Di chuyển con trỏ vào chỉ báo để biết trạng thái của SDK trong trò chơi và thời điểm gọi phương thức LoadingAPI.ready() (mục 1.19.2). Có thể có màu xanh dương, xanh lá cây hoặc đỏ:

Tại sao lại thấy lỗi SDK is not defined, dù chỉ báo Game Ready cho thấy SDK đã được khởi tạo?

Quan trọng là phải khởi tạo SDK một cách chính xác: script /sdk.js phải được kết nối trước khi thực thi YaGames.init(). Chỉ báo Game Ready chỉ đăng ký liệu SDK đã được cài đặt trong trò chơi hay script cần thiết đã được kết nối hay chưa.

Nút Play ▶️

Nút Play là chỉ báo hoạt động của trò chơi. Thông qua các sự kiện game_api_pause/game_api_resume, nền tảng thông báo khi nào trò chơi cần tạm dừng hoặc tiếp tục trải nghiệm chơi.

Nhấn nút để mô phỏng hoạt động của sự kiện:

• ▶️ — trò chơi đang tập trung, quá trình chơi đang diễn ra.
• ⏸️ — trò chơi không tập trung, cửa sổ mua hàng được mở hoặc đang hiển thị quảng cáo.

Nút Gamepad 🎮

Nút gamepad 🎮 mô phỏng việc sử dụng các phương thức SDK GameplayAPI.start() và GameplayAPI.stop() (mục 1.19.3). Bấm vào đây để chuyển đổi giữa các trạng thái:

• Nền trắng (mặc định) — gameplay không được sử dụng trong trò chơi.
• Nền xanh — gameplay đang diễn ra.
• Nền đỏ — gameplay đang tạm dừng.

Nút giờ ⏱️

Nhấn vào đồng hồ ⏱️ để bật/tắt độ trong suốt của màn hình tải Yandex:

• Mute Game loader – độ trong suốt sẽ được tắt, khi bắt đầu trò chơi màn hình tải với biểu tượng trò chơi ở trung tâm sẽ hiển thị.
• Show Game loader – độ trong suốt sẽ được bật, biểu tượng tải của trò chơi trở nên trong suốt. Có thể xem những gì đang diễn ra với trò chơi trong quá trình tải.

Nút công cụ SDK mocks ⚒️

Tham số Choose Game Lang

Chức năng này cho phép bạn thay đổi ngôn ngữ, được tự động xác định cho trò chơi.

Cách hoạt động:

1. Nhấn vào Choose Game Lang.
2. Trong menu thả xuống, chọn ngôn ngữ.
3. Tải lại trò chơi. Ngôn ngữ đã chọn sẽ được áp dụng vào environment.i18n.lang.

Để quay trở lại việc xác định ngôn ngữ tự động:

1. Chọn tham số có ký hiệu ngôn ngữ (ví dụ, En ).
2. Trong danh sách thả xuống, chọn dòng đầu tiên Choose Game Lang.
3. Tải lại trò chơi.

Biểu tượng liên kết: 🔗 Game links mock is disabled / 🔗 Game links mock is enabled.

Với tham số này, việc tuân thủ mục yêu cầu 8.4.1 được kiểm tra. Nó được coi là đã được thực hiện nếu trong chế độ kiểm tra thay vì mở liên kết đến các trò chơi khác, một trang tĩnh được mở ra. Xem thêm chi tiết tại phương pháp kiểm tra.

Để bật hoặc tắt chế độ kiểm tra:

1. Chọn 🔗 Game links mock is disabled hoặc 🔗 Game links mock is enabled tương ứng.
2. Đợi 5 giây và tải lại trò chơi.

Biểu tượng con mắt: 👁 Remove the focus from the game / 👀 Return the focus to the game.

Nhấn vào nút để bỏ chọn trò chơi hoặc chọn lại nó. Điều này hữu ích cho việc gỡ lỗi và thử nghiệm trò chơi.

Biểu tượng tên lửa hoặc rùa: 🚀 Network throttling is disabled / 🐢 Network throttling is enabled.

Tên lửa và rùa thay đổi thời gian chờ phản hồi từ máy chủ. Nhấn nút này để chuyển đổi giữa các chế độ khác nhau:

• Trong chế độ tên lửa, thời gian chờ phản hồi từ máy chủ là tiêu chuẩn. Trò chơi hoạt động trong chế độ bình thường.

• Trong chế độ rùa, máy khách đòi hỏi phản hồi từ máy chủ ngay lập tức. Nếu trong thời gian ngắn không có phản hồi, trò chơi sẽ coi như máy chủ không phản hồi. Chế độ này được sử dụng khi kiểm tra trò chơi để mô phỏng lỗi. Ví dụ, nếu cần kiểm tra trò chơi với kết nối internet kém, hoặc để mô phỏng lỗi khi mua hàng, nếu máy chủ SDK không phản hồi kịp thời.

Biểu tượng tiền tệ: 🪙 Currency mock is disabled / 🪙 Currency mock is enabled.

Cài đặt này giả lập đơn vị tiền tệ trong trò chơi (tên và biểu tượng của yans):

• Currency mock is disabled — biểu tượng và tên của đơn vị tiền tệ yans sẽ là mặc định.

• Currency mock is enabled — đơn vị tiền trong trò chơi sẽ thay đổi tên và biểu tượng thành mô hình giả lập. Nếu:

  • tên và biểu tượng của tiền tệ đã được thay đổi thành yên — trong trò chơi, các phương thức SDK được sử dụng một cách chính xác để biểu diễn tiền tệ của cổng (tuân thủ mục yêu cầu 3.8);

  • tên và biểu tượng của tiền tệ không được thay đổi thành yên — trong trò chơi không sử dụng các phương thức để biểu diễn tiền tệ của cổng, và vi phạm mục yêu cầu 3.8. Trò chơi như vậy sẽ bị các điều hành viên từ chối. Cần phải chỉ rõ tên và biểu tượng của tiền tệ theo tài liệu hướng dẫn cho nhà phát triển.

Tiền tệ mô phỏng là loại tiền tệ điều kiện dùng để kiểm thử, được máy chủ phát ra. Các điều hành viên sử dụng TST như là tiền tệ mô phỏng, với biểu tượng là đồng yên ¥.