채팅 서버 연결¶

Hive SDK 채팅 기능은 Hive 채팅 소켓 서버와의 WebSocket 통신을 이용합니다. 따라서 Hive SDK 채팅 기능을 이용하려면, 먼저 아래 가이드를 참고해 Hive 채팅 소켓 서버와 연결해야 합니다.

연결 요청¶

채팅에 연결하려면 Chat 클래스 connect 메서드를 호출합니다. 이때, extraData 인자로 문자열 값을 전달해 부가 정보를 전달할 수 있습니다. 예를 들어 앱 DB에서 관리하는 앱 사용자 닉네임 문자열을 부가 정보로 전달한다면, 이를 채팅창에서 채팅 닉네임으로 사용하거나 채널에 입장했을 때 "_~님이 입장했습니다."와 같은 입장 이벤트 메시지를 구현하는 데 쓸 수 있습니다.

다음은 채팅 연결을 요청하는 예제 코드입니다.

Warning

Hive SDK 채팅 기능은 Hive SDK 인증 기능을 사용하여 로그인을 하고 PlayerID를 발급받은 사용자(게스트 계정 포함)만 이용할 수 있습니다.

UnityC++KotlinJavaSwiftObjective-C

using hive;

String extraData = "EXTRA_DATA";
Chat.connect(extraData, (ResultAPI result) => {
    if (result.isSuccess()) {
        // API Call Success
    }
});

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

Chat::connect(extraData, [=](ResultAPI const & result) {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import com.hive.Chat;
import com.hive.ResultAPI;

val extraData = "EXTRA_DATA"
Chat.connect(extraData, object : Chat.ConnectListener {
    override fun onResult(result: ResultAPI) {
        if (result.isSuccess) {
            // API Call Success
        }
    }
})

import com.hive.Chat;

String extraData = "EXTRA_DATA";
Chat.connect(extraData, result -> {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import HIVEService

let extraData = "EXTRA_DATA"
ChatInterface.connect(extraData: extraData) { result in
    if result.isSuccess {
        // API Call Success
    }
}

#import "HIVEService.h"

NSString *extraData = @"EXTRA_DATA";
[HiveChat connectWithExtraData:extraData handler:^(HIVEResultAPI * result) {
    if (result.isSuccess) {
        // API Call Success
    }
}];

연결 해제 요청¶

채팅 연결을 해제하려면 Chat 클래스 disconnect() 메서드를 호출합니다. 아래는 채팅 연결을 해제하는 예제 코드입니다.

Note

앱 사용자 계정이 로그아웃하면 채팅 연결 해제 요청을 자동으로 실행합니다.

UnityC++KotlinJavaSwiftObjective-C

using hive;

Chat.disconnect((ResultAPI result) => {
    if (result.isSuccess()) {
        // API Call Success
    }
});

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

Chat::disconnect([=](ResultAPI const & result) {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import com.hive.Chat;
import com.hive.ResultAPI;

Chat.disconnect(object : Chat.DisconnectListener {
    override fun onResult(result: ResultAPI) {
        if (result.isSuccess) {
            // API Call Success
        }
    }
})

import com.hive.Chat;

Chat.disconnect(result -> {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import HIVEService

ChatInterface.disconnect(result) {
    if result.isSuccess {
        // API Call Success
    }
}

#import "HIVEService.h"

[HiveChat disconnectWithHandler:^(HIVEResultAPI * result) {
    if (result.isSuccess) {
        // API Call Success
    }
}];

연결 상태 확인¶

앱 사용자가 현재 채팅에 연결되었는지 상태를 확인합니다. Chat 클래스 isConnected 메서드를 호출합니다.

다음은 채팅 연결 상태를 확인하는 예제 코드입니다.

UnityC++KotlinJavaSwiftObjective-C

using hive;

Boolean isConnected = Chat.isConnected();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

bool isConnected = Chat::isConnected();

import com.hive.Chat;

val isConnected = Chat.isConnected()

import com.hive.Chat;

Boolean isConnected = Chat.isConnected();

import HIVEService

let isConnected = ChatInterface.isConnected()

#import "HIVEService.h"

bool isConnected = [ChatInterface isConnected];

연결 이벤트 관리¶

Hive 채팅 소켓 서버 연결 상태를 감지하고 상태 변경 이벤트를 앱에 지속적으로 전달합니다. 자세한 이벤트 처리 방법은 이벤트 관리 > 연결 이벤트 문서를 참고하세요.