Classic/VPC 환경에서 이용 가능합니다.
초기화
Ncloud Chat을 사용하기 전에 초기화해야 합니다. 대시보드에서 확인한 프로젝트 ID를 추가해 주십시오. Ncloud Chat을 초기화하는 방법은 다음과 같습니다.
- 대시보드에 접속하여 설정 메뉴에서 프로젝트 아이디를 확인해 주십시오.
- 인스턴스를 초기화하려면 아래 코드를 사용해 주십시오.
Javascript
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
import * as ncloudchat from "ncloudchat";
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)
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)
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)
#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
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);
}