NowChatSdkCallbacks インターフェイス - Android

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分
  • NowChatSdkCallbacks インターフェイスには、ホストアプリケーションのコールバックで NowChatSDK からのアクションを構成または処理できるようにする関数が用意されています。

    表 : 1. プロパティ
    名前 タイプ 説明
    isFileCollectionBlocked ブール ホストアプリケーションで NowChat によるファイルピッカー開かないようにするかどうかを示すフラグ。
    有効な値:
    • true:ファイルピッカーが開かないようにします。
    • false:ファイルピッカーを開くことを許可します。
    isGalleryCollectionBlocked ブール ホストアプリケーションが NowChat でフォトギャラリーを開けないようにするかどうかを示すフラグ。
    有効な値:
    • true:フォトギャラリーが開かないようにします。
    • false:フォトギャラリーを開くことを許可します。
    isLocationCollectionBlocked ブール ホストアプリケーションが NowChat が位置情報配置にアクセスできないようにするかどうかを示すフラグ。
    有効な値:
    • true:位置情報配置へのアクセスを禁止します。
    • false:位置情報配置へのアクセスを防止しません。
    isPhotoCollection がブロックされました ブール ホストアプリケーションが NowChat によるカメラへのアクセスを防止するかどうかを示すフラグ。
    有効な値:
    • true:カメラへのアクセスを禁止します。
    • false:カメラへのアクセスを拒否しません。

    NowChatSdkCallbacks - loadUri(uri: Uri, context: Context)

    指定された URI を処理します (Web ビュー、カスタムタブ、外部ブラウザーなどで開くなど)。

    表 : 2. パラメーター
    名前 タイプ 説明
    URI URI 開く URI。
    context コンテキスト アプリケーションコンテキスト。
    表 : 3. 返される内容
    タイプ 説明
    なし

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

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun loadUri(uri: Uri, context: Context) {
    
        // Open the uri in a webview
        val webview = WebView(context)
        webview.loadUrl(uri.toString())
      }
    
      // Override other methods
    }

    NowChatSdkCallbacks - onExit(exitCode: NowChatExitCode)

    NowChat が終了したときに返す結果コードを設定します。

    このコールバックは、その全画面チャットが閉じられ、ユーザーがホスト アプリケーションに戻ったときに呼び出されます。

    表 : 4. パラメーター
    名前 タイプ 説明
    exitCode NowChatExitCode NowChat を終了する理由。
    有効な値:
    • ChatPluginNotInstalledError:チャットプラグインがインスタンスにインストールされていません。
    • SessionInitializationError: インスタンスとのセッションを初期化できません。
    • UserExit:ユーザーが上ボタンまたは戻るボタンを使用して終了しました
    • 不明:不明な理由。
    表 : 5. 返される内容
    タイプ 説明
    なし

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

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
    
      override fun onExit(exitCode: NowChatExitCode) {
        when (exitCode) {
          NowChatExitCode.UserExit -> Log.i("NowChat", "User exited using the up button or back button")
          NowChatExitCode.SessionInitializationError -> Log.i("NowChat", "Unable to initialize session with instance")
          NowChatExitCode.ChatPluginNotInstalledError -> Log.i("NowChat", " Chat plugin not installed on instance.")
          NowChatExitCode.Unknown -> Log.i("NowChat", "User exited for Unknown reason")
        }
      }
    
      // Override other methods
    }

    NowChatSdkCallbacks - provideProgressView(context: Context)

    NowChat UI データのロード時に表示するビューを返します。通常は、構成済みの進行状況不定バーです。

    表 : 6. パラメーター
    名前 タイプ 説明
    context コンテキスト ビューの作成に使用するアプリケーションコンテキスト。
    表 : 7. 返される内容
    タイプ 説明
    ビュー ロード時に NowChat サービスで使用されるビュー。

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

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun provideProgressView(context: Context): View? {
        return ProgressBar(context).apply {
          indeterminateTintList = ColorStateList.valueOf(
            MaterialColors.getColor(
              context,
              android.R.attr.colorPrimary,
              Color.BLACK)
          )
        }
    
        // Override other methods
      }
    }