Banner

Mô-đun này thực hiện việc hiển thị và xóa quảng cáo banner. Sau khi đọc phần liên quan đến động cơ trò chơi của bạn trên trang Giới thiệu JOGOS_SDK, bạn có thể sử dụng các chức năng liên quan như sau:

window.JOGOS_SDK.banner;

Yêu cầu quảng cáo

Vui lòng chắc chắn đọc Yêu cầu quảng cáo của chúng tôi, vì nếu trò chơi của bạn không tuân theo các yêu cầu này, trò chơi của bạn sẽ bị từ chối và không có bất kỳ phản hồi nào.

Yêu cầu hiển thị quảng cáo banner

Quảng cáo banner có tổng cộng 5 kích thước 可供选择：

• Bảng xếp hạng (728x90)
• Trung bình (300x250)
• Thiết bị di động (320x50)
• Trang chủ (468x60)
• Thiết bị di động lớn (320x100)

Hạn chế

• Chỉ có thể hiển thị 2 quảng cáo banner có kích thước khác nhau tại cùng một thời điểm
• Vị trí quảng cáo banner tương tự phải được hiển thị trong 60 giây trước khi có thể làm mới quảng cáo lại
• Nếu banner không tuân theo các quy tắc và kích thước trên, nó rất có thể không được hiển thị

Đầu tiên, bạn cần tạo một container cho quảng cáo banner trên màn hình, có thể tùy chọn chỉ định chiều rộng và chiều cao：

<div id="banner-container" style="width: 300px; height: 250px"></div>

Sau đó sử dụng phương pháp sau để yêu cầu hiển thị quảng cáo banner (lưu ý rằng id phải khớp với id của container)：

try {
  await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
  console.log('Banner request error', e);
}

Tại cùng một thời điểm tối đa chỉ có thể hiển thị hai quảng cáo banner, nếu không sẽ ném ra ngoại lệ：'500 At most two banners can be displayed at the same time'.

Thực hiện phương thức này với cùng một id sẽ thay thế quảng cáo hiện có, thực hiện lặp lại trong thời gian được 指定 (thường là 60 giây) sẽ ném ra ngoại lệ：500 The time for each call to method requestBanner cannot exceed ${time} seconds.

Xóa banner được 指定

Sau đó sử dụng phương pháp sau để xóa banner có id là giá trị được 指定：

await window.JOGOS_SDK.banner.clearBanner('banner-container');

Xóa tất cả các banner

Sau đó sử dụng phương pháp sau để xóa tất cả các banner：

await window.JOGOS_SDK.banner.clearAllBanners();

Kiểm thử cục bộ

Khi kiểm thử cục bộ, quảng cáo thực tế sẽ không được hiển thị, để xem hiệu ứng hiển thị cuối cùng, bạn có thể đóng gói trò chơi của mình và tải lên công cụ QA của nền tảng nhà phát triển để kiểm thử.