Phương pháp SDK

Yêu cầu 1.19

Khởi tạo SDK của Yandex Games và sử dụng các phương thức của nó được thực hiện nghiêm ngặt theo tài liệu và yêu cầu đối với trò chơi:

SDK được khởi tạo chính xác như được chỉ định trên trang Cài đặt và sử dụng SDK.
Tại thời điểm người chơi có thể bắt đầu chơi game, phải gọi phương thức ready() từ gameReadyAPI.
Sử dụng GameplayAPI là tùy chọn, tuy nhiên, nếu các phương thức GameplayAPI được sử dụng trong trò chơi, thì các thời điểm gửi sự kiện start() và stop() phải chính xác theo mô tả trong mục Gameplay.
Việc theo dõi các sự kiện game_api_pause và game_api_resume là không bắt buộc, tuy nhiên, nếu các phương thức ysdk.on() và ysdk.off() được sử dụng trong trò chơi, thì logic xử lý sự kiện phải chính xác theo như được mô tả trong phần Sự kiện tạm dừng và tiếp tục trò chơi.

Khởi tạo SDK

1.19.1. SDK được khởi tạo chính xác như được chỉ định trên trang Cài đặt và sử dụng SDK. Để yêu cầu được coi là đã được thực hiện, phải sử dụng loader cập nhật.

Kiểm tra tính cập nhật của loader

Khởi chạy trò chơi với bảng điều khiển debug.
Qua bảng điều khiển của nhà phát triển

Qua thanh địa chỉ
1. Mở bảng điều khiển Yandex Games.
2. Chọn trò chơi bạn muốn.
3. Ở góc trên bên trái, nhấn vào Open with debug panel.
1. Mở trò chơi bạn muốn.
2. Thêm &debug-mode=16 vào cuối dòng địa chỉ trình duyệt.
Copied
Trên bảng điều khiển debug, bên trái chỉ báo Game Ready, tìm hai chữ cái:
- IF (init false) — trò chơi hỗ trợ loader cũ. Khi rê chuột lên IF, sẽ xuất hiện dòng chữ Is loader: false.
- IT (init true) — trò chơi hỗ trợ loader mới. Khi rê chuột lên IT, sẽ xuất hiện dòng chữ Is loader: true.

Ví dụ

Loader	Bình luận
	Loader cũ. Trên bảng điều khiển debug hiển thị `IF`.
	Loader cũ. Trên bảng điều khiển debug hiển thị `IF`.
	Loader mới. Trên bảng điều khiển debug hiển thị `IT`.
	Loader mới. Trên bảng điều khiển debug hiển thị `IT`.

Game Ready

1.19.2. Khi người chơi đã sẵn sàng bắt đầu trò chơi, hãy gọi phương thức LoadingAPI.ready() từ Game Ready.

Để yêu cầu được coi là đã hoàn thành, phương thức LoadingAPI.ready() phải được gọi vào thời điểm chính xác.

Lôgic kiểm tra Game Ready

Chuẩn bị

Khởi động trò chơi với bảng điều khiển debug.
Qua bảng điều khiển của nhà phát triển

Qua thanh địa chỉ
1. Mở bảng điều khiển Yandex Games.
2. Chọn trò chơi bạn muốn.
3. Ở góc trên bên trái, nhấn vào Open with debug panel.
1. Mở trò chơi bạn muốn.
2. Thêm &debug-mode=16 vào cuối dòng địa chỉ trình duyệt.
Copied
Trên bảng điều khiển debug, tìm kiếm chỉ báo Game Ready .

Nguyên tắc kiểm tra chung

Kiểm tra xem chỉ báo màu xanh chuyển thành màu xanh lục trong vòng 90 giây.
Khởi động lại trò chơi.
Kiểm tra lại thời điểm chỉ báo thay đổi màu sắc.

Game Ready hoạt động chính xác

Chỉ báo màu xanh chuyển thành màu xanh lục vào thời điểm:

khi menu có sẵn;
khi trò chơi có sẵn để tương tác (bao gồm cả hoạt ảnh đầu tiên).

Game Ready	Bình luận
	Chỉ báo màu xanh lục xuất hiện khi menu có sẵn.
	Chỉ báo màu xanh lục xuất hiện khi menu có sẵn.
	Chỉ báo màu xanh lục xuất hiện khi menu có sẵn.
	Đèn báo xanh sẽ xuất hiện khi trò chơi sẵn sàng cho tương tác.
	Đèn báo xanh sẽ xuất hiện khi trò chơi sẵn sàng cho tương tác.
	Đèn báo xanh sẽ xuất hiện khi trò chơi sẵn sàng cho tương tác.

Game Ready hoạt động không chính xác

Đèn báo màu xanh lá đã chuyển sang màu xanh lục :

trước khi trò chơi trở nên sẵn sàng để tương tác (có thanh tiến trình, biểu tượng loading, màn hình đen, v.v.);
vài giây sau khi trò chơi sẵn sàng để tương tác.

Game Ready	Bình luận
	Đèn báo màu xanh xuất hiện trước khi trò chơi sẵn sàng cho tương tác.
	Đèn báo màu xanh xuất hiện trước khi trò chơi sẵn sàng cho tương tác.
	Đèn báo màu xanh xuất hiện trước khi trò chơi sẵn sàng cho tương tác.
	Đèn báo xanh chỉ xuất hiện sau vài giây kể từ khi trò chơi sẵn sàng để tương tác.
	Đèn báo xanh chỉ xuất hiện sau vài giây kể từ khi trò chơi sẵn sàng để tương tác.

Game Ready không được tích hợp

Đèn báo chuyển sang màu đỏ sau 90 giây.

Game Ready	Bình luận
	Đèn báo chuyển sang màu đỏ — Game Ready không được tích hợp.

Đánh dấu gameplay

1.19.3. Các phương thức GameplayAPI.start() và GameplayAPI.stop() cho phép đánh dấu bắt đầu và dừng quá trình chơi game. Nếu chúng được sử dụng trong game, thì thời điểm gửi sự kiện sẽ chính xác tương ứng với những gì được mô tả trong mục Gameplay.

Kiểm tra đánh dấu gameplay

Chuẩn bị

Khởi động game với bảng debug.
Qua bảng điều khiển của nhà phát triển

Qua thanh địa chỉ
1. Mở bảng điều khiển Yandex Games.
2. Chọn trò chơi bạn muốn.
3. Ở góc trên bên trái, nhấn vào Open with debug panel.
1. Mở trò chơi bạn muốn.
2. Thêm &debug-mode=16 vào cuối dòng địa chỉ trình duyệt.
Copied
Trên bảng debug, tìm nút gamepad 🎮.

Nguyên tắc chung trong kiểm tra

Theo dõi trạng thái của chỉ báo gameplay tùy thuộc vào hành động:

Khi người chơi bắt đầu quá trình chơi game hoặc tiếp tục sau khi tạm dừng, phương thức GameplayAPI.start() phải được gọi. Chỉ báo gameplay phải chuyển sang màu xanh — gameplay đang diễn ra.
Khi người chơi kết thúc quá trình chơi game hoặc tạm dừng, phương thức GameplayAPI.stop() phải được gọi. Chỉ báo gameplay phải chuyển sang màu đỏ — gameplay đang tạm dừng.

Các kịch bản được xem xét khi kiểm tra:

Khởi động và kết thúc cấp độ.
Mở và đóng menu game.
Mở và đóng menu mua hàng.
Khởi động và đóng quảng cáo.
Mất tập trung khỏi game và quay trở lại game (chuyển sang tab khác của trình duyệt hoặc cửa sổ khác).

Lời khuyên

Để biết nơi tập trung (trong game hoặc ở cửa sổ khác), theo dõi sự kiện game_api_resume và game_api_pause.

Gameplay được đánh dấu đúng

Màu của chỉ báo thay đổi tùy thuộc vào tình huống.

Trò chơi	Bình luận
	Khi bắt đầu một cấp độ mới, chỉ báo chuyển sang màu xanh.
	Cấp độ kết thúc, chỉ báo chuyển sang màu đỏ.
	Khi chuyển sang menu và sau khi quay trở lại quá trình chơi, chỉ báo thay đổi.
	Khi chuyển sang menu và sau khi quay trở lại quá trình chơi, chỉ báo thay đổi.
	Khi chuyển sang menu mua hàng và sau khi quay trở lại quá trình chơi, chỉ báo thay đổi.
	Quảng cáo đóng lại, màu của chỉ báo đổi từ đỏ sang xanh.
	Khi chuyển trọng tâm từ tab trình duyệt sang cửa sổ khác và sau khi quay trở lại quá trình chơi, màu của chỉ báo thay đổi.

Gameplay được đánh dấu sai

Màu của chỉ báo không thay đổi tùy thuộc vào tình huống.

Trò chơi	Bình luận
	Cấp độ kết thúc, màu của chỉ báo không đổi từ xanh sang đỏ.
	Khi chuyển sang menu, màu của chỉ báo không đổi từ xanh sang đỏ.
	Quảng cáo đóng lại, màu của chỉ báo không đổi từ đỏ sang xanh.
	Khi chuyển trọng tâm từ tab trình duyệt sang cửa sổ khác, màu của chỉ báo không thay đổi.

Liên hệ với ban quản lý

Nếu bạn cho rằng mình đã sử dụng các phương pháp SDK đúng cách và trò chơi của bạn bị gỡ bỏ khỏi xuất bản hoặc bị từ chối không đúng lý do — hãy điền vào mẫu dưới đây.

Dịch vụ kiểm soát chất lượng quản lý sẽ kiểm tra lại quyết định và trả lại trò chơi nếu nó đã bị chặn một cách không công bằng.

Mở biểu mẫu

Was the article helpful?

Vi phạm cơ bản

Cơ chế trò chơi