初期化

Prev Next

Classic/VPC環境で利用できます。

初期化

Ncloud Chatを使用する前に初期化します。ダッシュボードから確認したプロジェクト IDを追加します。Ncloud Chatを初期化する方法は、次の通りです。

  1. ダッシュボードにアクセスし、設定メニューでプロジェクト IDを確認します。
  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 言語コード(「ja」、「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 言語コード(「ja」、「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* 言語コード(「ja」、「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 言語コード(「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);
}