H5AdsWebViewClient

Kotlin |Java

@RequiresApi(api = VERSION_CODES.LOLLIPOP)
class H5AdsWebViewClient : WebViewClient

kotlin.Any
↳	android.webkit.WebViewClient
	↳	com.google.android.gms.ads.h5.H5AdsWebViewClient

A WebViewClient that intercepts and handles H5 ad requests. To use this, set this as the client of the WebView that contains the web apps that will be making H5 ad requests.

IMPORTANT: This WebViewClient cannot be used for multiple WebViews. Every new WebView that will support H5 ads must use a new H5AdsWebViewClient.

Example code:

public void onCreate(Bundle savedInstanceState) {
  ...

  // Initialize early to reduce latency on the session's first ad request.
  MobileAds.initialize(this);

  WebView myWebView = findViewById(R.id.my_webview);

  // JavaScript must be enabled.
  WebSettings settings = myWebView.getSettings();
  settings.setJavaScriptEnabled(true);

  H5AdsWebViewClient h5Client = new H5AdsWebViewClient(this, myWebView);

  // (Optional) any existing WebViewClient
  WebViewClient myClient = ...;
  h5Client.setDelegateWebViewClient(myClient);

  webView.setWebViewClient(h5Client);
}

Summary

Public constructors
`H5AdsWebViewClient(context: Context!, webView: WebView!)` Constructor for `H5AdsWebViewClient`.

Public functions
`Unit`	`clearAdObjects()` Destroys all ads being managed by H5 ads.
`WebViewClient?`	`getDelegateWebViewClient()` Gets the delegate `WebViewClient`.
`Unit`	`setDelegateWebViewClient(delegate: WebViewClient?)` Sets a `WebViewClient` to delegate methods not handled by `H5AdsWebViewClient`.

Protected functions
`WebViewClient!`	`getDelegate()`

Inherited Constants

From android.webkit.WebViewClient

`const Int`	`ERROR_AUTHENTICATION = -4`
`const Int`	`ERROR_BAD_URL = -12`
`const Int`	`ERROR_CONNECT = -6`
`const Int`	`ERROR_FAILED_SSL_HANDSHAKE = -11`
`const Int`	`ERROR_FILE = -13`
`const Int`	`ERROR_FILE_NOT_FOUND = -14`
`const Int`	`ERROR_HOST_LOOKUP = -2`
`const Int`	`ERROR_IO = -7`
`const Int`	`ERROR_PROXY_AUTHENTICATION = -5`
`const Int`	`ERROR_REDIRECT_LOOP = -9`
`const Int`	`ERROR_TIMEOUT = -8`
`const Int`	`ERROR_TOO_MANY_REQUESTS = -15`
`const Int`	`ERROR_UNKNOWN = -1`
`const Int`	`ERROR_UNSAFE_RESOURCE = -16`
`const Int`	`ERROR_UNSUPPORTED_AUTH_SCHEME = -3`
`const Int`	`ERROR_UNSUPPORTED_SCHEME = -10`
`const Int`	`SAFE_BROWSING_THREAT_BILLING = 4`
`const Int`	`SAFE_BROWSING_THREAT_MALWARE = 1`
`const Int`	`SAFE_BROWSING_THREAT_PHISHING = 2`
`const Int`	`SAFE_BROWSING_THREAT_UNKNOWN = 0`
`const Int`	`SAFE_BROWSING_THREAT_UNWANTED_SOFTWARE = 3`

Inherited functions

From android.webkit.WebViewClient

`Unit`	`doUpdateVisitedHistory(p: WebView!, p1: String!, p2: Boolean)`
`Unit`	`onFormResubmission(p: WebView!, p1: Message!, p2: Message!)`
`Unit`	`onLoadResource(p: WebView!, p1: String!)`
`Unit`	`onPageCommitVisible(p: WebView!, p1: String!)`
`Unit`	`onPageFinished(p: WebView!, p1: String!)`
`Unit`	`onPageStarted(p: WebView!, p1: String!, p2: Bitmap!)`
`Unit`	`onReceivedClientCertRequest(p: WebView!, p1: ClientCertRequest!)`
`Unit`	`onReceivedError(p: WebView!, p1: WebResourceRequest!, p2: WebResourceError!)`
`Unit`	`onReceivedHttpAuthRequest( p: WebView!, p1: HttpAuthHandler!, p2: String!, p3: String! )`
`Unit`	`onReceivedHttpError( p: WebView!, p1: WebResourceRequest!, p2: WebResourceResponse! )`
`Unit`	`onReceivedLoginRequest(p: WebView!, p1: String!, p2: String!, p3: String!)`
`Unit`	`onReceivedSslError(p: WebView!, p1: SslErrorHandler!, p2: SslError!)`
`Boolean`	`onRenderProcessGone(p: WebView!, p1: RenderProcessGoneDetail!)`
`Unit`	`onSafeBrowsingHit( p: WebView!, p1: WebResourceRequest!, p2: Int, p3: SafeBrowsingResponse! )`
`Unit`	`onScaleChanged(p: WebView!, p1: Float, p2: Float)`
`Unit`	`onTooManyRedirects(p: WebView!, p1: Message!, p2: Message!)` This function is deprecated.
`Unit`	`onUnhandledKeyEvent(p: WebView!, p1: KeyEvent!)`
`WebResourceResponse!`	`shouldInterceptRequest(p: WebView!, p1: WebResourceRequest!)`
`Boolean`	`shouldOverrideKeyEvent(p: WebView!, p1: KeyEvent!)`
`Boolean`	`shouldOverrideUrlLoading(p: WebView!, p1: WebResourceRequest!)`

Public constructors

H5AdsWebViewClient

H5AdsWebViewClient(context: Context!, webView: WebView!)

Constructor for H5AdsWebViewClient.

Parameters
`context: Context!`	An activity or application context.
`webView: WebView!`	The `WebView` that will be associated with this `H5AdsWebViewClient`. JavaScript must be enabled on the WebView.

Public functions

clearAdObjects

fun clearAdObjects(): Unit

Destroys all ads being managed by H5 ads.

Note: This method has no effect on any ads created by the non-H5 AdMob API, such as com.google.android.gms.ads.interstitial.InterstitialAd and com.google.android.gms.ads.rewarded.RewardedAd.

getDelegateWebViewClient

fun getDelegateWebViewClient(): WebViewClient?

Gets the delegate WebViewClient.

setDelegateWebViewClient

fun setDelegateWebViewClient(delegate: WebViewClient?): Unit

Sets a WebViewClient to delegate methods not handled by H5AdsWebViewClient.

Protected functions

getDelegate

protected fun getDelegate(): WebViewClient!