NowWebService クラス: Android

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

    表 : 1. プロパティ
    名前 タイプ 説明
    構成 NowServiceConfiguration クラス: Android ServiceNowインスタンスの URL やパッケージの名前など、関連付けられたサービスの構成情報。

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

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

    表 : 2. パラメーター
    名前 タイプ 説明
    context コンテキスト 関連アクティビティを起動するために使用するコンテキスト。
    URL URL ロードする Web ページの URL。この Web ページは、サービスが初期化されたターゲット ServiceNow インスタンス上にある必要があります。
    theme NowWebテーマ オプション。ビューコントローラーの 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. パラメーター
    名前 タイプ 説明
    preloadUri リスト プリロードする java.net.URI のリスト。すべての java.net.URI は相対的であるか、NowSDK で構成されている現在のホストと一致する必要があります。
    表 : 5. 戻り値
    タイプ 説明
    なし

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

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