초기화

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

초기화

Ncloud Chat을 사용하기 전에 초기화해야 합니다. 대시보드에서 확인한 프로젝트 ID를 추가해 주십시오. Ncloud Chat을 초기화하는 방법은 다음과 같습니다.

  1. 대시보드에 접속하여 설정 메뉴에서 프로젝트 아이디를 확인해 주십시오.
  2. 인스턴스를 초기화하려면 아래 코드를 사용해 주십시오.

Javascript

  • Ncloud Chat 인스턴스를 생성합니다.
const nc = new ncloudchat.Chat();
  • 프로젝트 ID로 Ncloud Chat을 초기화합니다.
nc.initialize([PROJECT_ID]);
Parameter Type Description Required
PROJECT_ID string ID (Ncloud Chat 대시보드 Project ID) O

Typescript

  • Ncloud Chat 모듈을 임포트합니다.
import * as ncloudchat from "ncloudchat";
  • Ncloud Chat 인스턴스를 생성합니다.
const nc = new ncloudchat.Chat();
  • 프로젝트 ID로 Ncloud Chat을 초기화합니다.
nc.initialize([PROJECT_ID]);
Parameter Type Description Required
PROJECT_ID string ID (Ncloud Chat 대시보드 Project ID) O

Android (Kotlin)

  • NChat 모듈을 임포트합니다.
import com.nbase.sdk.NChat
  • NChat을 초기화합니다.
    projectId, region, language 설정을 입력합니다.
NChat.initialize(this, [PROJECT_ID], [REGION], [LANGUAGE]) { data, e ->
     if (e != null) {
        // 초기화 실패 시 오류 처리를 합니다.
     } else {
        // 초기화 성공 시 필요한 작업을 합니다.
     }
}
Parameter Type Description Required
PROJECT_ID String ID (Ncloud Chat 대시보드 Project ID) O
REGION String 리전 (별도로 사용하는 경우가 아니라면 "kr"으로 사용) O
LANGUAGE String 언어 코드 ("en", "ko" 등) O

iOS (Swift)

  • NChat 모듈을 임포트합니다.
import NChat

class ChatViewController: ConnectDelegate {
    func onConnect() {
    }
    func onDisconnect() {
    }
    func onMessage(data: Any) {
    }
    ...
}
  • 이벤트를 받을 클래스를 지정합니다.
let chatViewController = ChatViewController()
NChat.setDelegate(delegate: chatViewController)
  • NChat을 초기화합니다.
    projectId, region, language 설정을 입력합니다.
NChat.initialize(projectId: [PROJECT_ID], region: [REGION], language: [LANGUAGE]) { result in
    switch(result)
    {
    case .success(let status):
        // 초기화 성공 시 필요한 작업을 합니다.
        break;
    case .failure(let error):
        // 초기화 실패 시 오류 처리를 합니다.
        break;
    }
}
Parameter Type Description Required
PROJECT_ID String ID (Ncloud Chat 대시보드 Project ID) O
REGION String 리전 (별도로 사용하는 경우가 아니라면 "kr"으로 사용) O
LANGUAGE String 언어 코드 ("en", "ko" 등) O

iOS (Objective-C)

  • NChat 브릿지 모듈을 사용합니다.
#import "NChatObjCSample-Swift.h"
  • NChat을 초기화합니다.
    projectId, region, language 설정을 입력합니다.
[NChatBridge.shared initializeWithProjectId:[PROJECT_ID] region:[REGION] language:[LANGUAGE] :^(NSNumber * _Nullable result, NSError * _Nullable error) {
    if (error) {
        // 초기화 실패 시 오류 처리를 합니다.
    } else {
        // 초기화 성공 시 필요한 작업을 합니다.
    }
}];
Parameter Type Description Required
PROJECT_ID NSString* ID (Ncloud Chat 대시보드 Project ID) O
REGION NSString* 리전 (별도로 사용하는 경우가 아니라면 "kr"으로 사용) O
LANGUAGE NSString* 언어 코드 ("en", "ko" 등) O

Unity

  • NBaseSDK 모듈을 임포트합니다.
using NBaseSDK;
  • NBaseSDK Chat 인스턴스를 생성합니다.
NBaseSDK.Chat nc = NBaseSDK.Chat.GetInstance();
  • 프로젝트 ID와 리전, 언어 코드로 Ncloud Chat을 초기화합니다.
nc.initialize([PROJECT_ID], [REGION], [LANGUAGE]);
Parameter Type Description Required
PROJECT_ID string ID (Ncloud Chat 대시보드 Project ID) O
REGION string 리전 (별도로 사용하는 경우가 아니라면 "kr"으로 사용) O
LANGUAGE string 언어 코드 ("en", "ko" 등) O

오류 처리

  • 기본적인 오류 처리는 아래와 같이 try ... catch 안에 코드를 추가합니다.

Javascript/Typescript

try
{
    // 오류가 발생할 수 있는 코드를 이곳에 작성합니다.
    ...
} 
catch(e)
{
    // 오류가 발생했을 때 실행됩니다.
    console.log(e);
}

iOS

switch(result)
{
case .success(let status):
    // 초기화 성공 시 실행됩니다.
    break;
case .failure(let error):
    // 초기화 실패 시 실행됩니다.
    break;
}

Unity

try
{
    // 오류가 발생할 수 있는 코드를 이곳에 작성합니다.
    ...
} 
catch (InvalidOperationException e)
{
    // 특정 오류 타입에 대한 처리를 이곳에 작성합니다.
    Console.WriteLine("InvalidOperationException: {0}", e.Message);
}
catch(Exception e)
{
    // 일반적인 오류 처리를 이곳에 작성합니다.
    Console.WriteLine("Error: {0}", e.Message);
}