제품에 관해 논의하고 의견을 제공하려면 Google 광고 및 측정 커뮤니티 서버의 공식 Ad Manager Discord 채널에 참여하세요.

InterstitialAdPreloader

Kotlin |Java

class InterstitialAdPreloader

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

요약

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

java-static fun destroy(preloadId: String!): Boolean

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

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

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

java-static fun destroyAll(): Unit

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

java-static fun getConfiguration(preloadId: String!): PreloadConfiguration?

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

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

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

java-static fun getConfigurations(): (Mutable)Map<String!, PreloadConfiguration!>!

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

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

java-static fun getNumAdsAvailable(preloadId: String!): Int

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

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

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

java-static fun isAdAvailable(preloadId: String!): Boolean

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

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

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

java-static fun pollAd(preloadId: String!): InterstitialAd?

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

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

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

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

java-static fun start(preloadId: String!, preloadConfiguration: PreloadConfiguration!): Boolean

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

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

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

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

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

java-static fun start(
    preloadId: String!,
    preloadConfiguration: PreloadConfiguration!,
    preloadCallback: PreloadCallbackV2!
): Boolean

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

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

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

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

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

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