---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowChatSdkCallbacks 인터페이스 - Android

# NowChatSdkCallbacks 인터페이스 - Android {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분

NowChatSdkCallbacks 인터페이스는 호스트 애플리케이션에 대한 콜백이 NowChatSDK의 작업을 구성하거나 처리할 수 있도록 하는 기능을 제공합니다.  
{#NowChatSdkCallbacksAndroidInt__table_vx2_klw_5pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| isFileCollectionBlocked | 부울 | 호스트 애플리케이션이 NowChat에서 파일 선택기를 열지 못하도록 해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 파일 선택기가 열리지 않도록 합니다. * false: 파일 선택기가 열리도록 허용합니다. {#NowChatSdkCallbacksAndroidInt__ul_wwq_c2x_wpb} |
| isGalleryCollectionBlocked | 부울 | 호스트 애플리케이션이 NowChat에서 사진 갤러리를 열지 못하도록 해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사진 갤러리가 열리지 않도록 합니다. * false: 사진 갤러리가 열리도록 허용합니다. {#NowChatSdkCallbacksAndroidInt__ul_csw_32x_wpb} |
| isLocationCollectionBlocked | 부울 | 호스트 애플리케이션이 NowChat이 지리적 위치 포지셔닝에 액세스하지 못하도록 해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 지리적 위치 포지셔닝에 대한 액세스를 차단합니다. * false: 지리적 위치 포지셔닝에 대한 액세스를 차단하지 않습니다. {#NowChatSdkCallbacksAndroidInt__ul_pbb_j2x_wpb} |
| isPhotoCollection 차단됨 | 부울 | 호스트 애플리케이션이 NowChat이 카메라에 액세스하는 것을 방지해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 카메라에 대한 접근을 차단합니다. * false: 카메라에 대한 접근을 차단하지 않습니다. {#NowChatSdkCallbacksAndroidInt__ul_mkl_r2x_wpb} |
[표 1. 속성]

{#NowChatSdkCallbacksAndroidInt__table_vx2_klw_5pb}

## NowChatSdkCallbacks - didEndSessionWithId(sessionId: 문자열) {#ariaid-title2}

채팅 화면이 닫히고 채팅 세션이 종료될 때 호출됩니다.
주:  
함수를 재정의하여 이 콜백에 대해 원하는 기능을 정의해야 하며, 기본 구현은 로그에 "채팅 세션이 종료$sessionId." 메시지를 작성하기만 하면 됩니다.
{#NChatSdkCall-didEndSessionWId_S__table_izz_j4x_t2c__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sessionId | 문자열 | 종료된 세션의 Sys_id입니다. 테이블: 대화 세션 \[sys_cs_session\] |
[표 2. 매개변수]

{#NChatSdkCall-didEndSessionWId_S__table_izz_j4x_t2c} {#NChatSdkCall-didEndSessionWId_S__table_jzz_j4x_t2c__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#NChatSdkCall-didEndSessionWId_S__table_jzz_j4x_t2c}  
다음 코드 예제에서는 기본 기능을 재정의하기 위해 코드를 배치할 위치를 보여 줍니다.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun didEndSessionWithId(sessionId: String) {
        Log.i("NowChat", "Chat session $sessionId ended.")
      }

    //override other methods

    }

## NowChatSdkCallbacks - loadUri(uri: Uri, context: Context) {#ariaid-title3}

지정된 URI를 처리합니다(예: 웹 뷰, 사용자 지정 탭 또는 외부 브라우저에서 열기).
{#NChatSdkCall-loadUri_S_O__table_wg5_fxf_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| uri | [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html) | 열 URI입니다. |
| 컨텍스트 | [컨텍스트](https://developer.android.com/reference/kotlin/android/content/Context.html) | 애플리케이션 컨텍스트 |
[표 4. 매개변수]

{#NChatSdkCall-loadUri_S_O__table_wg5_fxf_tpb} {#NChatSdkCall-loadUri_S_O__table_xg5_fxf_tpb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#NChatSdkCall-loadUri_S_O__table_xg5_fxf_tpb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    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) {#ariaid-title4}

NowChat을 종료할 때 반환할 결과 코드를 설정합니다.
이 콜백은 전체 화면 채팅이 종결되고 사용자가 호스트 애플리케이션으로 돌아올 때 호출됩니다.
{#NChatSdkCall-onExit_S__table_pj1_z1g_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| exitCode | NowChatExitCode | NowChat을 종료하는 이유입니다. 유효한 값은 다음과 같습니다. * ChatPluginNotInstalledError: 채팅 플러그인이 인스턴스에 설치되어 있지 않습니다. * SessionInitializationError: 인스턴스로 세션을 초기화할 수 없습니다. * UserExit: 사용자가 위로 버튼 또는 뒤로 버튼을 사용하여 종료했습니다. * 알 수 없음: 알 수 없는 이유입니다. |
[표 6. 매개변수]

{#NChatSdkCall-onExit_S__table_pj1_z1g_tpb} {#NChatSdkCall-onExit_S__table_qj1_z1g_tpb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 7. 반환]

{#NChatSdkCall-onExit_S__table_qj1_z1g_tpb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    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(컨텍스트: 컨텍스트) {#ariaid-title5}

NowChat UI 데이터가 로드될 때 표시할 뷰를 반환합니다. 일반적으로 구성된 불확정 진행률 표시줄입니다.
{#NChatSdkCall-provideProgressView_O__table_lbx_k2g_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 컨텍스트 | [컨텍스트](https://developer.android.com/reference/kotlin/android/content/Context.html) | 뷰를 생성하는 데 사용할 애플리케이션 컨텍스트입니다. |
[표 8. 매개변수]

{#NChatSdkCall-provideProgressView_O__table_lbx_k2g_tpb} {#NChatSdkCall-provideProgressView_O__table_mbx_k2g_tpb__entry__2}

| 유형 | 설명 |
|-|-|
| [뷰](https://developer.android.com/reference/kotlin/android/view/View.html) | 로드 시 NowChat 서비스가 사용하는 뷰입니다. |
[표 9. 반환]

{#NChatSdkCall-provideProgressView_O__table_mbx_k2g_tpb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    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
      }
    }