Classic/VPC環境で利用できます。
初期化
Ncloud Chatを使用する前に初期化します。ダッシュボードから確認したプロジェクト IDを追加します。Ncloud Chatを初期化する方法は、次の通りです。
- ダッシュボードにアクセスし、設定メニューでプロジェクト IDを確認します。
- インスタンスを初期化するには、以下のコードを使用します。
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
- Ncloud Chatモジュールをインポートします。
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 |
言語コード(「ja」、「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 |
言語コード(「ja」、「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* |
言語コード(「ja」、「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 |
言語コード(「ja」、「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);
}