NowWebService クラス: Android

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • NowWebService API は、Web ビューをホストする NowWebActivity を起動する関数を提供します。

    表 : 1. プロパティ
    名前 タイプ Description (説明)
    構成 NowServiceConfiguration クラス - Android ServiceNowインスタンスの URL やパッケージの名前など、関連するサービスの構成情報。

    NowWebService - launch(context: Context, url: URL, theme: NowWebTheme)

    Web ビューをホストする NowWebActivity を作成します。

    表 : 2. パラメーター
    名前 タイプ 説明
    context コンテキスト 関連アクティビティを起動するために使用するコンテキスト。
    url URL ロードする Web ページの URL。この Web ページは、サービスが初期化されたターゲット ServiceNow インスタンス上にある必要があります。
    theme NowWebTheme オプション。ビュー コントローラーの UI 要素に適用する NowWebTheme

    デフォルト:デフォルトのテーマ

    表 : 3. 返される内容
    タイプ 説明
    なし

    次のコード例は、この関数を呼び出す方法を示しています。

    lifecycleScope.launch {
      sdkManager.getNowWebService()?.launch(this@MainActivity, URL("https://instance-name.service-now.com"), object : NowWebTheme {
        override val brand: NowUIAdaptiveColor
          //Setting lightColor only. For dark theme default color will be used
          get() = NowUIAdaptiveColor(lightColor = Color.BLACK)
    
        override val primary: NowUIAdaptiveColor
          //Setting both lightColor and darkColor
          get() = NowUIAdaptiveColor(lightColor = Color.BLACK, darkColor = Color.WHITE)
    
        //override the rest of color variables
      })
    }

    NowWebService – preloadWebCache(preloadUris: List<URI>)

    指定されたjava.net.URIのリストをヘッドレスWebビューにプリロードして、ページ上のキャッシュ可能なリソースをWebビューキャッシュに事前入力します。

    注:
    この関数呼び出しの完了は、Webビューで呼び出される onPageFinished() に基づいており、ページ上のリダイレクトやリソースは考慮されていません。このため、このメソッドが戻ったときにプリロードが完全に完了しない場合があります。
    表 : 4. パラメーター
    名前 タイプ Description (説明)
    preloadUris リスト プリロードする java.net.URI のリスト。すべての java.net.URI は、相対であるか、NowSDK で構成されている現在のホストと一致する必要があります。
    表 : 5. 返される内容
    タイプ 説明
    なし

    次の例は、 webService.preloadWebCache() 関数を使用して mesp ページをプリロードする方法を示しています。

    suspend fun preloadNowWeb() {
      val webService = serviceProvider.webService()
      webService.preloadWebCache(
        listOf(
          URI("mesp")
        )
      )
    }