Lớp: AdsManager

google.ima.AdsManager

class static

Cung cấp API công khai bên ngoài cho nhà xuất bản và giao tiếp với bản sao nội bộ của trình quản lý quảng cáo.

Phương pháp

thu gọn

thu gọn()

Thu gọn quảng cáo hiện tại. Đây là tuỳ chọn không hoạt động cho SDK HTML5.

định cấu hìnhAdsAdsManager

configAdsManager(content, adsRenderingSettings)

Đặt các thông số bắt buộc để lấy thông tin tham chiếu đến Ad Manager này từ sự kiện AdsManagerLoaded.

Thông số
nội dung	Đối tượng Đối tượng phát lại nội dung của nhà xuất bản. Không được để trống giá trị.
Cài đặt quảng cáo hiển thị	Không bắt buộc Cài đặt hiển thị quảng cáo Các chế độ cài đặt không bắt buộc để kiểm soát việc hiển thị quảng cáo. Giá trị có thể rỗng.

hủy bỏ

hủy()

Xóa các thành phần quảng cáo được tải trong thời gian chạy cần được xóa đúng cách tại thời điểm hoàn thành quảng cáo, đồng thời ngừng quảng cáo và tất cả hoạt động theo dõi.

hủy quảng cáo xen giữa

hủyAdBreak()

Nếu điểm chèn quảng cáo hiện đang phát, hãy loại bỏ quảng cáo đó và tiếp tục nội dung. Nếu không, hãy bỏ qua điểm chèn quảng cáo theo lịch tiếp theo. Ví dụ: Bạn có thể gọi lệnh này ngay sau khi trình quản lý quảng cáo tải để bỏ qua quảng cáo trước video mà không bỏ sót quảng cáo trong video hoặc sau video trong tương lai. Đây là không hoạt động trừ khi yêu cầu quảng cáo trả về danh sách phát hoặc phản hồi VMAP.

mở rộng

mở rộng()

Mở rộng quảng cáo hiện tại. Đây là tuỳ chọn không hoạt động cho SDK HTML5.

tiêu điểm

focus()

Đặt tiêu điểm vào nút bỏ qua (nếu có). Nếu không có tiêu điểm, hệ thống sẽ tập trung vào các thành phần tương tác, bao gồm cả biểu tượng hoặc mẫu quảng cáo tương tác.

Có thể bỏ qua trạng thái

getAdSkipState() trả về boolean

Trả về true nếu hiện có thể bỏ qua quảng cáo. Khi giá trị này thay đổi, AdsManager sẽ kích hoạt một sự kiện AdEvent.SKIPPABLE_STATE_CHANGED.

Trả về

boolean True nếu quảng cáo hiện có thể được bỏ qua, false nếu không.

getCuePoints

getCuePoints() trả về Mảng số

Trả về một mảng chênh lệch tính bằng giây cho biết thời điểm ngắt quảng cáo được lên lịch. Quảng cáo trước video được biểu thị bằng 0 và quảng cáo sau video được biểu thị bằng -1. Một mảng trống cho biết quảng cáo hoặc nhóm quảng cáo đó không có lịch biểu và có thể phát bất cứ lúc nào.

Trả về

non-null Array of number Danh sách chênh lệch về thời gian tính bằng giây.

Nhận thời gian còn lại

getRemainingTime() trả về số

Xem thời gian còn lại của quảng cáo hiện đang phát. Nếu quảng cáo chưa được tải hoặc đã phát xong, API sẽ trả về -1.

Trả về

number Trả về thời gian còn lại của quảng cáo hiện tại. Nếu thời gian còn lại không xác định cho quảng cáo hiện tại (ví dụ: quảng cáo tuỳ chỉnh), thì giá trị sẽ trả về -1.

nhận âm lượng

getVolume() trả về số

Nhận khối lượng cho quảng cáo hiện tại.

Trả về

number Âm lượng của quảng cáo hiện tại, từ 0 (bị tắt tiếng) đến 1 (lớn nhất).

init

init(chiều rộng, chiều cao, viewMode, videoElement)

Gọi init để khởi chạy trải nghiệm quảng cáo trên trình quản lý quảng cáo.

Thông số
chiều rộng	number Chiều rộng quảng cáo đã chọn.
độ cao	number Chiều cao quảng cáo đã chọn.
Chế độ xem	Chế độ xem Chế độ xem đã chọn. Không được để trống giá trị.
videoElement	Không bắt buộc Phần tử video HTML Phần tử video để phát tuỳ chỉnh. Phần tử video này ghi đè phần tử được cung cấp trong hàm khởi tạo AdDisplayContainer. Bạn chỉ nên sử dụng thuộc tính này nếu thực sự cần thiết. Nếu không, bạn nên chỉ định phần tử video này trong khi tạo AdDisplayContainer. Giá trị có thể rỗng.

isCustomClickTrackingUse

isCustomClickTrackingUse() trả về boolean

Trả về true nếu đang sử dụng phần tử theo dõi lượt nhấp tuỳ chỉnh để theo dõi lượt nhấp trên quảng cáo hiện tại. Tính năng theo dõi lượt nhấp tuỳ chỉnh chỉ được sử dụng khi bạn cung cấp phần tử theo dõi lượt nhấp tuỳ chọn cho AdDisplayContainer, phát lại tuỳ chỉnh và quảng cáo hiện tại không phải là quảng cáo AdSense/AdX.

Trả về

boolean Có sử dụng tính năng theo dõi lượt nhấp tuỳ chỉnh hay không.

Đã sử dụng isCustomPlayback

isCustomPlayback luật() trả về boolean

Trả về true nếu sử dụng phần tử video tuỳ chỉnh để phát quảng cáo hiện tại. Tính năng phát tuỳ chỉnh diễn ra khi bạn cung cấp một phần tử video không bắt buộc cho AdDisplayContainer trên các nền tảng mà phần tử video tuỳ chỉnh cung cấp trải nghiệm xem quảng cáo liền mạch hơn.

Trả về

boolean Có sử dụng tính năng phát tuỳ chỉnh hay không.

tạm dừng

tạm dừng()

Tạm dừng quảng cáo hiện đang phát. Hàm này sẽ không hoạt động khi lớp phủ tĩnh đang hiển thị hoặc nếu quảng cáo chưa được tải hoặc phát xong.

đổi kích thước

đổi kích thước(chiều rộng, chiều cao, viewMode)

Đổi kích thước quảng cáo hiện tại.

Thông số
chiều rộng	number Chiều rộng vùng quảng cáo mới.
độ cao	number Chiều cao vùng quảng cáo mới.
Chế độ xem	Chế độ xem Chế độ xem mới. Không được để trống giá trị.

tiếp tục

tiếp tục()

Tiếp tục quảng cáo hiện tại đã được tải và tạm dừng. Hàm này sẽ không hoạt động khi lớp phủ tĩnh đang hiển thị hoặc nếu quảng cáo chưa được tải hoặc phát xong.

đặt âm lượng

setVolume(âm lượng)

Đặt âm lượng cho quảng cáo hiện tại.

Thông số
thể tích	number Âm lượng được đặt, từ 0 (đã tắt tiếng) đến 1 (lớn nhất).

bỏ qua

skip()

Bỏ qua quảng cáo hiện tại khi AdsManager.getAdSkippableState() có giá trị true. Khi được gọi trong các trường hợp khác, việc bỏ qua không có hiệu lực. Sau khi bỏ qua hoàn tất, AdsManager sẽ kích hoạt một sự kiện AdEvent.SKIPPED.

bắt đầu

start()

Bắt đầu phát quảng cáo.

Trước tiên, nhà phát triển phải gọi AdDisplayContainer.initialize().

dừng

dừng()

Ngừng phát quảng cáo. Khi bạn gọi số này, nhà xuất bản sẽ quay lại nội dung.

updateAdsRenderingSettings

updateAdsRenderingSettings(adsRenderingSettings)

Cập nhật chế độ cài đặt hiển thị quảng cáo. Bạn nên sử dụng chỉ số này riêng cho các trường hợp sử dụng VMAP giữa các điểm chèn quảng cáo khi cần cập nhật các chế độ cài đặt hiển thị quảng cáo, chẳng hạn như tốc độ bit.

Thông số
Cài đặt quảng cáo hiển thị	Cài đặt hiển thị quảng cáo Chế độ cài đặt hiển thị quảng cáo đã cập nhật. Không được để trống giá trị.