InterstitialAdPreloader

Kotlin |자바

public final class InterstitialAdPreloader

전면 광고의 프리로더입니다.

요약

공개 메서드
`static boolean`	`destroy(String preloadId)` 지정된 `preloadId`의 미리 로드를 중지하고 연결된 모든 미리 로드된 광고를 삭제합니다.
`static void`	`destroyAll()` 모든 미리 로드 구성에 대해 미리 로드를 중지하고 미리 로드된 광고를 삭제합니다.
`static @Nullable PreloadConfiguration`	`getConfiguration(String preloadId)` 이 메서드는 지원 중단되었습니다. 교체되지 않음
`static Map<String, PreloadConfiguration>`	`getConfigurations()` 이 메서드는 지원 중단되었습니다. 교체되지 않음
`static int`	`getNumAdsAvailable(String preloadId)` 지정된 사전 로드 ID에 사용 가능한 광고 수를 반환합니다.
`static boolean`	`isAdAvailable(String preloadId)` 지정된 `preloadId`에 사용할 수 있는 광고가 하나 이상 있는지 확인합니다.
`static @Nullable InterstitialAd`	`pollAd(String preloadId)` `start` 또는 `start`에서 미리 로드된 광고를 반환하고 캐시에서 삭제합니다.
`static boolean`	`start(String preloadId, PreloadConfiguration preloadConfiguration)` 지정된 `preloadId` 및 `PreloadConfiguration`에 대한 광고 미리 로드를 시작합니다.
`static boolean`	`start( String preloadId, PreloadConfiguration preloadConfiguration, PreloadCallbackV2 preloadCallback )` 지정된 `preloadId`, `PreloadConfiguration`, 의 광고 미리 로드를 시작합니다 .

public static boolean destroy(String preloadId)

지정된 preloadId의 미리 로드를 중지하고 연결된 모든 미리 로드된 광고를 삭제합니다.

매개변수
`String preloadId`	삭제할 구성의 미리 로드 ID입니다.

반환 값
`boolean`	활성 미리 로드 구성이 삭제된 경우 `true` 지정된 `preloadId`에 활성 프리로드 구성이 없으면 `false`를 반환합니다.

public static void destroyAll()

모든 미리 로드 구성에 대해 미리 로드를 중지하고 미리 로드된 광고를 삭제합니다.

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

이 preloadId와 연결된 전면 광고 PreloadConfiguration를 반환합니다. 연결된 광고가 없으면 null을 반환합니다.

매개변수
`String preloadId`	이 구성에 연결된 미리 로드 ID입니다.

반환 값
`@Nullable PreloadConfiguration`	지정된 미리 로드 ID의 `PreloadConfiguration` 또는 지정된 미리 로드 ID의 구성이 없는 경우 `null`

public static Map<String, PreloadConfiguration> getConfigurations()

연결된 사전 로드 ID를 키로 사용하여 모든 전면 광고 PreloadConfiguration의 맵을 반환합니다.

반환 값
`Map<String, PreloadConfiguration>`	전면 광고 구성 또는 프리로더가 없는 경우 빈 맵입니다.

public static int getNumAdsAvailable(String preloadId)

지정된 사전 로드 ID에 사용 가능한 광고 수를 반환합니다.

매개변수
`String preloadId`	사용 가능 여부를 확인할 미리 로드 ID입니다.

반환 값
`int`	지정된 미리 로드 ID에 사용할 수 있는 광고 수입니다.

public static boolean isAdAvailable(String preloadId)

지정된 preloadId에 사용할 수 있는 광고가 하나 이상 있는지 확인합니다.

매개변수
`String preloadId`	사용 가능 여부를 확인할 미리 로드 ID입니다.

반환 값
`boolean`	지정된 미리 로드 ID에 사용할 수 있는 광고가 있으면 `true`, 그렇지 않으면 `false`

public static @Nullable InterstitialAd pollAd(String preloadId)

start 또는 start에서 미리 로드된 광고를 반환하고 캐시에서 삭제합니다.

이는 preloadId에 대해 미리 로드된 광고 중 하나일 수 있습니다. 반환된 순서는 onAdPreloaded 이벤트의 순서와 일치하지 않을 수 있습니다.

매개변수
`String preloadId`	광고의 미리 로드 ID입니다.

반환 값
`@Nullable InterstitialAd`	지정된 미리 로드 ID의 전면 광고입니다. 광고를 사용할 수 없는 경우 `null`입니다.

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

지정된 preloadId 및 PreloadConfiguration에 대한 광고 미리 로드를 시작합니다.

SDK는 getBufferSize로 지정된 광고 수에 도달할 때까지 광고를 미리 로드하며 세션 전체에서 버퍼를 가득 채우려고 시도합니다.

preloadId로 PreloadConfiguration가 이미 시작된 경우 이 메서드는 아무 작업도 실행하지 않고 false를 반환합니다.

매개변수
`String preloadId`	이 `PreloadConfiguration`의 문자열 식별자입니다. 이 구성을 위한 광고를 가져오기 위해 `pollAd`를 호출할 때 이 식별자를 사용합니다.
`PreloadConfiguration preloadConfiguration`	광고 미리 로드 구성입니다.

반환 값
`boolean`	미리 로드가 시작된 경우 `true`, preloadId가 사용 중인 경우 `false`

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

지정된 preloadId, PreloadConfiguration, 의 광고 미리 로드를 시작합니다 .

SDK는 getBufferSize로 지정된 광고 수에 도달할 때까지 광고를 미리 로드하며 세션 전체에서 버퍼를 가득 채우려고 시도합니다.

각 광고 요청에 대해 SDK는 사전 로드가 성공하면 onAdPreloaded 콜백을 트리거하고 사전 로드가 실패하면 onAdFailedToPreload 콜백을 트리거합니다. SDK는 실패한 요청을 자동으로 재시도합니다.

PreloadConfiguration가 지정된 preloadId로 이미 시작된 경우 이 메서드는 아무 작업도 실행하지 않고 false를 반환합니다. 작업이 없으며 false를 반환합니다.

매개변수
`String preloadId`	이 `PreloadConfiguration`를 고유하게 식별하는 문자열입니다. `pollAd`를 호출하여 이 구성의 미리 로드된 광고를 가져올 때 이 식별자를 사용합니다.
`PreloadConfiguration preloadConfiguration`	광고가 미리 로드되는 방식을 지정하는 구성입니다.
`PreloadCallbackV2 preloadCallback`	지정된 `PreloadConfiguration`의 광고 사용 가능 여부가 변경될 때 호출되는 콜백입니다.

반환 값
`boolean`	미리 로드가 시작된 경우 `true`, preloadId가 사용 중인 경우 `false`