AppOpenAdPreloader

Kotlin |Java

public final class AppOpenAdPreloader

Trình tải trước cho quảng cáo khi mở ứng dụng.

Tóm tắt

Phương thức công khai
`static boolean`	`destroy(String preloadId)` Dừng tải trước cho `preloadId` đã cho và huỷ tất cả quảng cáo được tải trước có liên quan.
`static void`	`destroyAll()` Dừng tải trước và huỷ quảng cáo được tải trước cho tất cả cấu hình tải trước.
`static @Nullable PreloadConfiguration`	`getConfiguration(String preloadId)` Trả về quảng cáo khi mở ứng dụng `PreloadConfiguration` được liên kết với `preloadId` này hoặc giá trị rỗng nếu không có quảng cáo nào.
`static Map<String, PreloadConfiguration>`	`getConfigurations()` Trả về một bản đồ gồm tất cả `PreloadConfiguration` quảng cáo khi mở ứng dụng, được khoá bằng mã nhận dạng tải trước được liên kết.
`static int`	`getNumAdsAvailable(String preloadId)` Trả về số lượng quảng cáo có sẵn cho mã nhận dạng tải trước đã cho.
`static boolean`	`isAdAvailable(String preloadId)` Xác định xem có ít nhất một quảng cáo cho `preloadId` đã cho hay không.
`static @Nullable AppOpenAd`	`pollAd(String preloadId)` Trả về một quảng cáo được tải sẵn từ `start` hoặc `start` và xoá quảng cáo đó khỏi bộ nhớ đệm.
`static boolean`	`start(String preloadId, PreloadConfiguration preloadConfiguration)` Bắt đầu tải trước quảng cáo cho `preloadId` và `PreloadConfiguration` đã cho.
`static boolean`	`start( String preloadId, PreloadConfiguration preloadConfiguration, PreloadCallbackV2 preloadCallback )` Bắt đầu tải trước quảng cáo cho `preloadId`, `PreloadConfiguration` và `PreloadCallbackV2` đã cho.

Phương thức công khai

hủy bỏ

public static boolean destroy(String preloadId)

Dừng tải trước cho preloadId đã cho và huỷ tất cả quảng cáo được tải trước có liên quan.

Thông số
`String preloadId`	Mã tải trước của cấu hình cần huỷ.

Giá trị trả về
`boolean`	`true` nếu một cấu hình tải trước đang hoạt động bị huỷ. Trả về `false` nếu không có cấu hình tải trước nào đang hoạt động cho `preloadId` đã cho.

destroyAll

public static void destroyAll()

Dừng tải trước và huỷ quảng cáo được tải trước cho tất cả cấu hình tải trước.

getConfiguration

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

Trả về quảng cáo khi mở ứng dụng PreloadConfiguration được liên kết với preloadId này hoặc giá trị rỗng nếu không có quảng cáo nào.

Thông số
`String preloadId`	Mã tải trước được liên kết với cấu hình này.

Giá trị trả về
`@Nullable PreloadConfiguration`	`PreloadConfiguration` cho mã tải trước đã cho hoặc `null` nếu không có cấu hình nào cho mã tải trước đã cho.

getConfigurations

public static Map<String, PreloadConfiguration> getConfigurations()

Trả về một bản đồ gồm tất cả PreloadConfiguration quảng cáo khi mở ứng dụng, được khoá bằng mã nhận dạng tải trước được liên kết.

Giá trị trả về
`Map<String, PreloadConfiguration>`	Cấu hình quảng cáo khi mở ứng dụng hoặc một bản đồ trống nếu không có trình tải trước.

getNumAdsAvailable

public static int getNumAdsAvailable(String preloadId)

Trả về số lượng quảng cáo có sẵn cho mã nhận dạng tải trước đã cho.

Thông số
`String preloadId`	Mã nhận dạng tải trước để kiểm tra tình trạng cung cấp.

Giá trị trả về
`int`	Số lượng quảng cáo có sẵn cho mã nhận dạng tải trước đã cho.

isAdAvailable

public static boolean isAdAvailable(String preloadId)

Xác định xem có ít nhất một quảng cáo cho preloadId đã cho hay không.

Thông số
`String preloadId`	Mã nhận dạng tải trước để kiểm tra tình trạng cung cấp.

Giá trị trả về
`boolean`	`true` nếu có quảng cáo cho mã tải trước đã cho, `false` nếu không.

pollAd

public static @Nullable AppOpenAd pollAd(String preloadId)

Trả về một quảng cáo được tải sẵn từ start hoặc start và xoá quảng cáo đó khỏi bộ nhớ đệm.

Xin lưu ý rằng đây có thể là bất kỳ quảng cáo nào được tải trước cho preloadId. Thứ tự được trả về không đảm bảo khớp với thứ tự của các sự kiện onAdPreloaded.

Thông số
`String preloadId`	Mã nhận dạng tải trước của quảng cáo.

Giá trị trả về
`@Nullable AppOpenAd`	Quảng cáo khi mở ứng dụng cho mã tải trước đã cho hoặc `null` nếu không có quảng cáo.

start

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

Bắt đầu tải trước quảng cáo cho preloadId và PreloadConfiguration đã cho.

SDK sẽ tiếp tục tải trước quảng cáo cho đến khi đạt được số lượng quảng cáo do getBufferSize chỉ định, cố gắng duy trì bộ nhớ đệm đầy trong suốt phiên.

Nếu PreloadConfiguration đã bắt đầu bằng preloadId, phương thức này sẽ không hoạt động và trả về false.

Thông số
`String preloadId`	Giá trị nhận dạng chuỗi cho `PreloadConfiguration` này. Sử dụng giá trị nhận dạng này khi gọi pollAd để nhận quảng cáo cho cấu hình này.
`PreloadConfiguration preloadConfiguration`	Cấu hình để tải trước quảng cáo.

Giá trị trả về
`boolean`	`true` nếu quá trình tải trước đã bắt đầu, `false` nếu preloadId đang được sử dụng.

start

public static boolean start(
    String preloadId,
    PreloadConfiguration preloadConfiguration,
    PreloadCallbackV2 preloadCallback
)

Bắt đầu tải trước quảng cáo cho preloadId, PreloadConfiguration và PreloadCallbackV2 đã cho.

Đối với mỗi yêu cầu quảng cáo, SDK sẽ kích hoạt lệnh gọi lại onAdPreloaded khi tải trước thành công hoặc lệnh gọi lại onAdFailedToPreload nếu quá trình tải trước không thành công. SDK sẽ tự động thử lại các yêu cầu không thành công.

Nếu PreloadConfiguration đã bắt đầu với preloadId đã cho, thì phương thức này sẽ không làm gì và trả về false. trở thành một thao tác không có hiệu lực và trả về false.

Thông số
`String preloadId`	Một chuỗi xác định duy nhất `PreloadConfiguration` này. Sử dụng giá trị nhận dạng này khi gọi `pollAd` để truy xuất một quảng cáo được tải sẵn cho cấu hình này.
`PreloadConfiguration preloadConfiguration`	Cấu hình quy định cách tải trước quảng cáo.
`PreloadCallbackV2 preloadCallback`	Một lệnh gọi lại sẽ được gọi khi trạng thái cung cấp quảng cáo thay đổi cho `PreloadConfiguration` đã cho.

Giá trị trả về
`boolean`	`true` nếu quá trình tải trước đã bắt đầu, `false` nếu preloadId đang được sử dụng.