HIVE SDK for Unity3D

클래스 | 열거형 타입 | 함수
Chat

Hive 채팅 서비스는 실시간 채팅, 그룹 채팅, 1:1 채팅, 사용자 간 차단 기능 등 앱에서 원활한 채팅을 할 수 있도록 핵심 기능을 제공한다. 더 자세히 ...

클래스

class  hive.Chat
 Hive 채팅 서비스는 실시간 채팅, 그룹 채팅, 1:1 채팅, 사용자 간 차단 기능 등 앱에서 원활한 채팅을 할 수 있도록 핵심 기능을 제공한다. 더 자세히 ...
 
class  hive.ChannelSendMessageParams
 채널 메시지 전송 객체
채널에 메시지를 전송하기 위한 정보를 담고 있는 객체이다. 더 자세히 ...
 
class  hive.DirectSendMessageParams
 1:1 메시지 전송 객체
특정 사용자에게 메시지를 전송하기 위한 정보를 담고 있는 객체이다. 더 자세히 ...
 
class  hive.CreateChannelParams
 채널 생성 객체
채널을 생성하기 위한 정보를 담고 있는 객체이다. 더 자세히 ...
 
class  hive.GetChannelsParams
 채널 정보 조회 객체
채널 정보를 조회하기 위한 객체이다. 더 자세히 ...
 
class  hive.EnterChannelParams
 채널 입장 객체
채널에 입장하기 위한 정보를 담고 있는 객체이다. 더 자세히 ...
 
class  hive.ChannelMessageListQueryParams
 채널 메시지 조회 객체
더 자세히 ...
 
class  hive.ChannelMessageListQueryResponse
 채널 메시지 조회 응답 객체
더 자세히 ...
 
class  hive.TranslateParams
 번역 요청 객체
더 자세히 ...
 
class  hive.Channel
 채널 정보 조회 시 반환되는 객체
채널 정보를 조회할 때 반환되는 객체이다. 더 자세히 ...
 
class  hive.ChannelPage
 채널 정보 조회시 반환되는 채널 페이지 객체
채널 정보를 조회할 때 반환되는 채널 페이지 객체이다. 더 자세히 ...
 
class  hive.Member
 멤버 및 채널 정보 조회시 반환되는 멤버 객체
멤버 및 채널 정보를 조회할 때 반환되는 멤버 객체이다. 더 자세히 ...
 
class  hive.BlockMember
 차단 멤버 조회시 반환되는 차단 멤버 객체
차단된 멤버를 조회할 때 반환되는 차단 멤버 객체이다. 더 자세히 ...
 
class  hive.EnteredMember
 채널에 입장한 멤버 객체
채널에 입장한 멤버 정보로 ChannelHandler.onEnteredMember 이벤트를 통해 전달 받는다. 더 자세히 ...
 
class  hive.ExitedMember
 채널에서 퇴장한 멤버 객체
채널에서 퇴장한 멤버 정보는 ChannelHandler.onExitedMember 이벤트를 통해 전달 받는다. 더 자세히 ...
 
class  hive.DeletedChannel
 삭제된 채널 정보 객체
삭제된 채널의 정보는 ChannelHandler.onDeletedChannel 이벤트를 통해 전달된다. 더 자세히 ...
 
class  hive.ChannelNoticeMessage
 채널 공지 메시지 객체
채널 공지 메시지 정보는 ChannelHandler.onNoticeMessage 이벤트를 통해 전달된다. 더 자세히 ...
 
class  hive.ChannelMessage
 채널 메시지 객체
채널 메시지 정보는 ChannelHandler.onChannelMessage 이벤트를 통해 전달된다. 더 자세히 ...
 
class  hive.DirectMessage
 1:1 메시지 객체
1:1 메시지 정보는 [DirectMessageListener.onDirectMessage] 이벤트를 통해 전달된다. 더 자세히 ...
 
class  hive.NoticeMessage
 사용자 공지 메시지 객체
사용자 공지 메시지 정보는 UserHandler.onNoticeMessage 이벤트를 통해 전달된다. 더 자세히 ...
 

열거형 타입

enum  hive.ChannelType
 채널 타입 더 자세히 ...
 
enum  hive.SortType
 정렬 기준 타입
채널 목록 조회시, 전달되는 결과 값의 정렬 기준 더 자세히 ...
 

함수

delegate void hive.Chat.onConnect (ResultAPI result)
 Hive 채팅 서버 연결 연결 후 결과
더 자세히 ...
 
delegate void hive.Chat.onReconnect (ResultAPI result, List< String > channelIds, List< String > failChannelIds)
 Hive 채팅 서버 재연결 후 결과
더 자세히 ...
 
delegate void hive.Chat.onDisconnect (ResultAPI result)
 Hive 채팅 서버 연결 해제 후 결과
더 자세히 ...
 
delegate void hive.Chat.onChannelSendMessage (ResultAPI result, ChannelSendMessageParams retryParams)
 채널 메시지 전송 후 결과 값을 전달하는 리스너
더 자세히 ...
 
delegate void hive.Chat.onDirectSendMessage (ResultAPI result, DirectSendMessageParams retryParams)
 1:1 메시지 전송 후 결과 값을 전달하는 리스너
더 자세히 ...
 
delegate void hive.Chat.onCreateChannel (ResultAPI result)
 채널 생성 후 결과
더 자세히 ...
 
delegate void hive.Chat.onGetChannels (ResultAPI result, List< Channel > channels, ChannelPage channelPage)
 채널 목록 조회 후 결과
더 자세히 ...
 
delegate void hive.Chat.onGetChannelInfo (ResultAPI result, Channel channel, List< Member > members)
 채널 정보 조회 후 결과
더 자세히 ...
 
delegate void hive.Chat.onGetChannelMembers (ResultAPI result, List< Member > members)
 채널 멤버 목록 조회 후 결과
더 자세히 ...
 
delegate void hive.Chat.onDeleteChannel (ResultAPI result)
 채널 삭제 후 결과
더 자세히 ...
 
delegate void hive.Chat.onEnterChannel (ResultAPI result)
 채널 입장 후 결과
더 자세히 ...
 
delegate void hive.Chat.onEixtChannel (ResultAPI result)
 채널 퇴장 후 결과
더 자세히 ...
 
delegate void hive.Chat.onGetChannelsByUser (ResultAPI result, List< Channel > channels)
 사용자 별 채널 목록 조회 후 결과
더 자세히 ...
 
delegate void hive.Chat.onGetBlockMembers (ResultAPI result, List< BlockMember > blockMembers)
 차단된 멤버 목록 조회 후 결과
더 자세히 ...
 
delegate void hive.Chat.onBlockMember (ResultAPI result)
 멤버 차단 후 결과
더 자세히 ...
 
delegate void hive.Chat.onUnblockMember (ResultAPI result)
 멤버 차단 해제 후 결과
더 자세히 ...
 
static void hive.Chat.connect (String extraData, onConnect listener)
 [Deprecated] Hive 채팅 서버 연결
이 API는 더 이상 사용을 권장하지 않으며, 향후 버전에서 제거될 예정입니다. 더 자세히 ...
 
static void hive.Chat.connect (onConnect listener)
 Hive 채팅 서버 연결
Hive 채팅 기능을 호출하기 전에 가장 먼저 호출되어야 하는 API로, 인증된 사용자 정보를 바탕으로 Hive 채팅 서버에 연결을 시도한다. 더 자세히 ...
 
static void hive.Chat.reconnect (onReconnect listener)
 Hive 채팅 서버 재연결
Hive 채팅 서버와 재연결한다. 더 자세히 ...
 
static void hive.Chat.disconnect (onDisconnect listener)
 Hive 채팅 서버 연결 해제
Hive 채팅 서버와 연결을 해제한다. 더 자세히 ...
 
static Boolean hive.Chat.isConnected ()
 현재 사용자의 Hive 채팅 서버 연결 상태를 조회
Hive 채팅 서버와의 연결 상태를 확인한다. 더 자세히 ...
 
static void hive.Chat.sendMessage (ChannelSendMessageParams param)
 채널 메시지 전송
사용자가 입장한 채널에 메시지를 전송하며, ChannelSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다. 더 자세히 ...
 
static void hive.Chat.sendMessage (ChannelSendMessageParams param, onChannelSendMessage listener)
 채널 메시지 전송
사용자가 입장한 채널에 메시지를 전송하며, ChannelSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다. 더 자세히 ...
 
static void hive.Chat.sendMessage (DirectSendMessageParams param)
 1:1 메시지 전송
특정 대상 사용자에게 메시지를 전송하며, DirectSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다. 더 자세히 ...
 
static void hive.Chat.sendMessage (DirectSendMessageParams param, onDirectSendMessage listener)
 1:1 메시지 전송
특정 대상 사용자에게 메시지를 전송하며, DirectSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다. 더 자세히 ...
 
static void hive.Chat.addConnectionHandler (String uniqueKey, ConnectionHandler connectionHandler)
 Hive 채팅 서버와 연결 상태를 감지하고 상태 변경 이벤트 수신
Hive 채팅 서버와 연결 상태를 감지하고 상태 변경 이벤트를 수신한다. 더 자세히 ...
 
static void hive.Chat.addChannelHandler (String uniqueKey, ChannelHandler channelHandler)
 Hive 채팅 서버에 연결된 사용자와 채널 간의 이벤트를 감지하고 변경 이벤트 수신
Hive 채팅 서버에 연결된 사용자와 채널 간의 이벤트를 감지하고 변경 이벤트를 수신한다. 더 자세히 ...
 
static void hive.Chat.addDirectMessageHandler (String uniqueKey, DirectMessageHandler directMessageHandler)
 Hive 채팅 서버에 연결된 사용자에게 전달된 1:1 메시지 이벤트를 감지하고 이벤트 수신
Hive 채팅 서버에 연결된 사용자에게 전달된 1:1 메시지 이벤트를 감지하고 해당 이벤트를 수신한다. 더 자세히 ...
 
static void hive.Chat.addUserHandler (String uniqueKey, UserHandler userHandler)
 Hive 채팅 서버에 연결된 사용자와 관련된 이벤트를 감지하고 수신하는 리스너를 등록합니다. 더 자세히 ...
 
static void hive.Chat.addCustomDataHandler (String uniqueKey, CustomDataHandler customDataHandler)
 Hive 채팅 서버에 연결된 사용자에게 전달된 커스텀 데이터를 감지하고 수신하는 리스너를 등록합니다. 더 자세히 ...
 
static void hive.Chat.removeConnectionHandler (String uniqueKey)
 등록된 연결 이벤트 핸들러(addConnectionHandler) 제거
등록된 연결 이벤트 핸들러를 제거한다. 더 자세히 ...
 
static void hive.Chat.removeChannelHandler (String uniqueKey)
 등록된 채널 이벤트 핸들러(addChannelHandler) 제거
등록된 채널 이벤트 핸들러를 제거한다. 더 자세히 ...
 
static void hive.Chat.removeDirectMessageHandler (String uniqueKey)
 등록된 1:1 메시지 이벤트 핸들러(addDirectMessageHandler) 제거
등록된 1:1 메시지 이벤트 핸들러를 제거한다. 더 자세히 ...
 
static void hive.Chat.removeUserHandler (String uniqueKey)
 등록된 사용자 이벤트 리스너(addUserHandler) 제거
등록된 UserHandler를 uniqueKey 기준으로 제거하며, 해당 유저와 관련된 DirectMessageNoticeMessage 이벤트 수신을 중단합니다. 더 자세히 ...
 
static void hive.Chat.removeCustomDataHandler (String uniqueKey)
 등록된 커스텀 데이터 이벤트 리스너(addCustomDataHandler) 제거
등록된 CustomDataHandler를 uniqueKey 기준으로 제거하며, 해당 유저와 관련된 커스텀 데이터 수신을 중단합니다. 더 자세히 ...
 
static void hive.Chat.createChannel (CreateChannelParams param, onCreateChannel listener)
 채널 생성
새로운 대화 채널을 생성한다. 더 자세히 ...
 
static void hive.Chat.getChannels (GetChannelsParams param, onGetChannels listener)
 현재 생성된 채널 목록 조회
현재 생성된 채널 목록을 조회한다. 더 자세히 ...
 
static void hive.Chat.getChannelInfo (String channelId, onGetChannelInfo listener)
 채널 정보 조회
특정 단일 채널의 상세 정보를 조회한다. 더 자세히 ...
 
static void hive.Chat.getChannelMembers (String channelId, onGetChannelMembers listener)
 채널 참여자 정보 조회
특정 채널의 참여자 정보를 조회한다. 더 자세히 ...
 
static void hive.Chat.deleteChannel (String channelId, onDeleteChannel listener)
 채널 삭제
채널을 삭제한다. 더 자세히 ...
 
static void hive.Chat.enterChannel (EnterChannelParams param, onEnterChannel listener)
 채널 입장
채널에 입장한다. 더 자세히 ...
 
static void hive.Chat.exitChannel (String channelId, onEixtChannel listener)
 채널 퇴장
현재 사용자가 참여한 채널에서 퇴장합니다. 더 자세히 ...
 
static void hive.Chat.getChannelsByUser (onGetChannelsByUser listener)
 사용자 참여 채널 조회
현재 사용자의 참여 중인 채널 목록을 조회한다. 더 자세히 ...
 
static void hive.Chat.getBlockMembers (onGetBlockMembers listener)
 사용자 차단 목록 조회
현재 사용자가 차단한 멤버 목록을 조회한다. 더 자세히 ...
 
static void hive.Chat.blockMember (Int64 blockPlayerId, onBlockMember listener)
 멤버 차단
현재 사용자가 특정 멤버를 차단한다. 더 자세히 ...
 
static void hive.Chat.unblockMember (Int64 blockPlayerId, onUnblockMember listener)
 멤버 차단 해제
현재 사용자가 차단한 멤버 중 특정 멤버의 차단을 해제한다. 더 자세히 ...
 

상세한 설명

Hive 채팅 서비스는 실시간 채팅, 그룹 채팅, 1:1 채팅, 사용자 간 차단 기능 등 앱에서 원활한 채팅을 할 수 있도록 핵심 기능을 제공한다.


열거형 타입 문서화

◆ ChannelType

채널 타입

◆ SortType

정렬 기준 타입
채널 목록 조회시, 전달되는 결과 값의 정렬 기준

함수 문서화

◆ addChannelHandler()

static void hive.Chat.addChannelHandler ( String  uniqueKey,
ChannelHandler  channelHandler 
)
static

Hive 채팅 서버에 연결된 사용자와 채널 간의 이벤트를 감지하고 변경 이벤트 수신
Hive 채팅 서버에 연결된 사용자와 채널 간의 이벤트를 감지하고 변경 이벤트를 수신한다.


매개변수
uniqueKey사용자 정의 고유 키
channelHandlerChannelHandler 채널 이벤트 핸들러

◆ addConnectionHandler()

static void hive.Chat.addConnectionHandler ( String  uniqueKey,
ConnectionHandler  connectionHandler 
)
static

Hive 채팅 서버와 연결 상태를 감지하고 상태 변경 이벤트 수신
Hive 채팅 서버와 연결 상태를 감지하고 상태 변경 이벤트를 수신한다.


매개변수
uniqueKey사용자 정의 고유 키
connectionHandlerConnectionHandler 연결 상태 핸들러

◆ addCustomDataHandler()

static void hive.Chat.addCustomDataHandler ( String  uniqueKey,
CustomDataHandler  customDataHandler 
)
static

Hive 채팅 서버에 연결된 사용자에게 전달된 커스텀 데이터를 감지하고 수신하는 리스너를 등록합니다.


유저 고유 키를 기준으로 CustomDataHandler를 등록하여, 해당 유저와 관련된 커스텀 데이터를 수신합니다.

매개변수
uniqueKey사용자 정의 고유 키
customDataHandlerCustomDataHandler 커스텀 데이터 이벤트 리스너

◆ addDirectMessageHandler()

static void hive.Chat.addDirectMessageHandler ( String  uniqueKey,
DirectMessageHandler  directMessageHandler 
)
static

Hive 채팅 서버에 연결된 사용자에게 전달된 1:1 메시지 이벤트를 감지하고 이벤트 수신
Hive 채팅 서버에 연결된 사용자에게 전달된 1:1 메시지 이벤트를 감지하고 해당 이벤트를 수신한다.


매개변수
uniqueKey사용자 정의 고유 키
directMessageHandlerDirectMessageHandler 1:1 메시지 이벤트 핸들러

◆ addUserHandler()

static void hive.Chat.addUserHandler ( String  uniqueKey,
UserHandler  userHandler 
)
static

Hive 채팅 서버에 연결된 사용자와 관련된 이벤트를 감지하고 수신하는 리스너를 등록합니다.


유저 고유 키를 기준으로 UserHandler를 등록하여, 해당 유저와 관련된 DirectMessageNoticeMessage 이벤트를 감지하고 수신합니다.

매개변수
uniqueKey사용자 정의 고유 키
userHandlerUserHandler 사용자 이벤트 리스너

◆ blockMember()

static void hive.Chat.blockMember ( Int64  blockPlayerId,
onBlockMember  listener 
)
static

멤버 차단
현재 사용자가 특정 멤버를 차단한다.


매개변수
blockPlayerId차단할 멤버의 playerId
listeneronBlockMember

◆ connect() [1/2]

static void hive.Chat.connect ( onConnect  listener)
static

Hive 채팅 서버 연결
Hive 채팅 기능을 호출하기 전에 가장 먼저 호출되어야 하는 API로, 인증된 사용자 정보를 바탕으로 Hive 채팅 서버에 연결을 시도한다.



기본적으로 60초 이내에 연결되지 않으면 ResultAPI.Code.ChatResponseError 가 발생한다.
Configuration.setChatConnectionTimeout() API를 사용하여 Hive 채팅 서버 연결을 위한 최대 시간을 재 설정할 수 있다.

연결 상태를 감지하고 상태 변경 이벤트를 수신하기 위해 Chat.addConnectionHandler 이벤트 핸들러를 등록해야 한다.

매개변수
listeneronConnect

◆ connect() [2/2]

static void hive.Chat.connect ( String  extraData,
onConnect  listener 
)
static

[Deprecated] Hive 채팅 서버 연결
이 API는 더 이상 사용을 권장하지 않으며, 향후 버전에서 제거될 예정입니다.


대신 {connect(onConnect)}를 사용하세요.

Hive 채팅 기능을 호출하기 전에 가장 먼저 호출되어야 하는 API로, 인증된 사용자 정보를 바탕으로 Hive 채팅 서버에 연결을 시도한다.

기본적으로 60초 이내에 연결되지 않으면 ResultAPI.Code.ChatResponseError 가 발생한다.
Configuration.setChatConnectionTimeout() API를 사용하여 Hive 채팅 서버 연결을 위한 최대 시간을 재 설정할 수 있다.

연결 상태를 감지하고 상태 변경 이벤트를 수신하기 위해 Chat.addConnectionHandler 이벤트 핸들러를 등록해야 한다.

매개변수
extraData사용자 설정 데이터 (예: 닉네임)
listeneronConnect
잘못된 코드:
v25.2.0부터 사용 중단, 대신 {connect(onConnect)}를 사용

◆ createChannel()

static void hive.Chat.createChannel ( CreateChannelParams  param,
onCreateChannel  listener 
)
static

채널 생성
새로운 대화 채널을 생성한다.


매개변수
param채널 생성에 필요한 매개변수를 포함한 객체
listeneronCreateChannel

◆ deleteChannel()

static void hive.Chat.deleteChannel ( String  channelId,
onDeleteChannel  listener 
)
static

채널 삭제
채널을 삭제한다.


매개변수
channelId삭제할 채널의 ID
listeneronDeleteChannel

◆ disconnect()

static void hive.Chat.disconnect ( onDisconnect  listener)
static

Hive 채팅 서버 연결 해제
Hive 채팅 서버와 연결을 해제한다.

인증된 사용자 정보가 사인 아웃 될 때, 이 API는 자동호출 된다.

매개변수
listeneronDisconnect

◆ enterChannel()

static void hive.Chat.enterChannel ( EnterChannelParams  param,
onEnterChannel  listener 
)
static

채널 입장
채널에 입장한다.


매개변수
param채널 입장 정보
listeneronEnterChannel

◆ exitChannel()

static void hive.Chat.exitChannel ( String  channelId,
onEixtChannel  listener 
)
static

채널 퇴장
현재 사용자가 참여한 채널에서 퇴장합니다.

채널 소유자가 퇴장하는 경우, 해당 채널은 삭제됩니다.

매개변수
channelId퇴장할 채널 ID
listeneronExitChannel

◆ getBlockMembers()

static void hive.Chat.getBlockMembers ( onGetBlockMembers  listener)
static

사용자 차단 목록 조회
현재 사용자가 차단한 멤버 목록을 조회한다.


매개변수
listeneronGetBlockMembers

◆ getChannelInfo()

static void hive.Chat.getChannelInfo ( String  channelId,
onGetChannelInfo  listener 
)
static

채널 정보 조회
특정 단일 채널의 상세 정보를 조회한다.


매개변수
channelId정보를 조회할 채널의 ID
listeneronGetChannelInfo

◆ getChannelMembers()

static void hive.Chat.getChannelMembers ( String  channelId,
onGetChannelMembers  listener 
)
static

채널 참여자 정보 조회
특정 채널의 참여자 정보를 조회한다.


매개변수
channelId정보를 조회할 채널의 ID
listeneronGetChannelMembers

◆ getChannels()

static void hive.Chat.getChannels ( GetChannelsParams  param,
onGetChannels  listener 
)
static

현재 생성된 채널 목록 조회
현재 생성된 채널 목록을 조회한다.

GetChannelsParams 객체를 구성하여 조회하고자 하는 채널에 대한 필터를 설정할 수 있다.

매개변수
param채널을 필터링하기 위한 객체
listeneronGetChannels

◆ getChannelsByUser()

static void hive.Chat.getChannelsByUser ( onGetChannelsByUser  listener)
static

사용자 참여 채널 조회
현재 사용자의 참여 중인 채널 목록을 조회한다.


매개변수
listeneronGetChannelsByUser

◆ isConnected()

static Boolean hive.Chat.isConnected ( )
static

현재 사용자의 Hive 채팅 서버 연결 상태를 조회
Hive 채팅 서버와의 연결 상태를 확인한다.


반환값
연결되었으면 true, 아니면 false 반환

◆ onBlockMember()

delegate void hive.Chat.onBlockMember ( ResultAPI  result)

멤버 차단 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ onChannelSendMessage()

delegate void hive.Chat.onChannelSendMessage ( ResultAPI  result,
ChannelSendMessageParams  retryParams 
)

채널 메시지 전송 후 결과 값을 전달하는 리스너

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
  • ResultAPI.Code.CommonUnknown 알 수 없는 에러

◆ onConnect()

delegate void hive.Chat.onConnect ( ResultAPI  result)

Hive 채팅 서버 연결 연결 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음(인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 이미 연결되거나 네트워크 에러 또는 기타 에러

◆ onCreateChannel()

delegate void hive.Chat.onCreateChannel ( ResultAPI  result)

채널 생성 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ onDeleteChannel()

delegate void hive.Chat.onDeleteChannel ( ResultAPI  result)

채널 삭제 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ onDirectSendMessage()

delegate void hive.Chat.onDirectSendMessage ( ResultAPI  result,
DirectSendMessageParams  retryParams 
)

1:1 메시지 전송 후 결과 값을 전달하는 리스너

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
  • ResultAPI.Code.CommonUnknown 알 수 없는 에러

◆ onDisconnect()

delegate void hive.Chat.onDisconnect ( ResultAPI  result)

Hive 채팅 서버 연결 해제 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ onEixtChannel()

delegate void hive.Chat.onEixtChannel ( ResultAPI  result)

채널 퇴장 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ onEnterChannel()

delegate void hive.Chat.onEnterChannel ( ResultAPI  result)

채널 입장 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ onGetBlockMembers()

delegate void hive.Chat.onGetBlockMembers ( ResultAPI  result,
List< BlockMember blockMembers 
)

차단된 멤버 목록 조회 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
blockMembers차단된 멤버 목록

◆ onGetChannelInfo()

delegate void hive.Chat.onGetChannelInfo ( ResultAPI  result,
Channel  channel,
List< Member members 
)

채널 정보 조회 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
channel채널 정보 (null일 수 있음)
members채널에 속한 멤버 목록

◆ onGetChannelMembers()

delegate void hive.Chat.onGetChannelMembers ( ResultAPI  result,
List< Member members 
)

채널 멤버 목록 조회 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
members채널에 속한 멤버 목록

◆ onGetChannels()

delegate void hive.Chat.onGetChannels ( ResultAPI  result,
List< Channel channels,
ChannelPage  channelPage 
)

채널 목록 조회 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
channels조회된 채널 목록
channelPage채널 페이지 정보

◆ onGetChannelsByUser()

delegate void hive.Chat.onGetChannelsByUser ( ResultAPI  result,
List< Channel channels 
)

사용자 별 채널 목록 조회 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러
channels사용자와 연결된 채널 목록

◆ onReconnect()

delegate void hive.Chat.onReconnect ( ResultAPI  result,
List< String >  channelIds,
List< String >  failChannelIds 
)

Hive 채팅 서버 재연결 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음(인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 이미 연결되거나 네트워크 에러 또는 기타 에러
channelIds성공적으로 재연결된 채널 ID 목록
failChannelIds재연결 실패한 채널 ID 목록

◆ onUnblockMember()

delegate void hive.Chat.onUnblockMember ( ResultAPI  result)

멤버 차단 해제 후 결과

매개변수
API호출 결과
  • ResultAPI.Code.Success 성공
  • ResultAPI.Code.ChatNotConnected Hive 채팅 서버와 연결되지 않음 (재연결 필요)
  • ResultAPI.Code.ChatNeedSignIn Hive 인증이 진행되지 않음 (인증 확인 필요)
  • ResultAPI.Code.ChatResponseError 네트워크 에러 또는 기타 에러

◆ reconnect()

static void hive.Chat.reconnect ( onReconnect  listener)
static

Hive 채팅 서버 재연결
Hive 채팅 서버와 재연결한다.

<

재연결은 기존의 접속이 끊긴지 10분이 지나지 않았다면, 기존에 접속되어있던 채널에 다시 접속한다.
마지막으로 연결이 끊긴지 10분이 지났거나, 이전 연결기록이 없다면 connect와 동일하게 동작한다.

연결 상태를 감지하고 상태 변경 이벤트를 수신하기 위해 Chat.addConnectionHandler 이벤트 핸들러를 등록해야 한다.

매개변수
listeneronReconnect

◆ removeChannelHandler()

static void hive.Chat.removeChannelHandler ( String  uniqueKey)
static

등록된 채널 이벤트 핸들러(addChannelHandler) 제거
등록된 채널 이벤트 핸들러를 제거한다.


매개변수
uniqueKey사용자 정의 고유 키

◆ removeConnectionHandler()

static void hive.Chat.removeConnectionHandler ( String  uniqueKey)
static

등록된 연결 이벤트 핸들러(addConnectionHandler) 제거
등록된 연결 이벤트 핸들러를 제거한다.


매개변수
uniqueKey사용자 정의 고유 키

◆ removeCustomDataHandler()

static void hive.Chat.removeCustomDataHandler ( String  uniqueKey)
static

등록된 커스텀 데이터 이벤트 리스너(addCustomDataHandler) 제거
등록된 CustomDataHandler를 uniqueKey 기준으로 제거하며, 해당 유저와 관련된 커스텀 데이터 수신을 중단합니다.


매개변수
uniqueKey사용자 정의 고유 키

◆ removeDirectMessageHandler()

static void hive.Chat.removeDirectMessageHandler ( String  uniqueKey)
static

등록된 1:1 메시지 이벤트 핸들러(addDirectMessageHandler) 제거
등록된 1:1 메시지 이벤트 핸들러를 제거한다.


매개변수
uniqueKey사용자 정의 고유 키

◆ removeUserHandler()

static void hive.Chat.removeUserHandler ( String  uniqueKey)
static

등록된 사용자 이벤트 리스너(addUserHandler) 제거
등록된 UserHandler를 uniqueKey 기준으로 제거하며, 해당 유저와 관련된 DirectMessageNoticeMessage 이벤트 수신을 중단합니다.


매개변수
uniqueKey사용자 정의 고유 키

◆ sendMessage() [1/4]

static void hive.Chat.sendMessage ( ChannelSendMessageParams  param)
static

채널 메시지 전송
사용자가 입장한 채널에 메시지를 전송하며, ChannelSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다.



전달된 채널 메시지를 수신하기 위해 Chat.addChannelHandler 이벤트 핸들러를 등록해야 한다.

매개변수
paramChannelSendMessageParams 메시지 전송 정보

◆ sendMessage() [2/4]

static void hive.Chat.sendMessage ( ChannelSendMessageParams  param,
onChannelSendMessage  listener 
)
static

채널 메시지 전송
사용자가 입장한 채널에 메시지를 전송하며, ChannelSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다.



메시지 전송 결과는 전달된 onChannelSendMessage 콜백을 통해 받을 수 있으며,
전역적으로 메시지를 수신하려면 Chat.addChannelHandler 이벤트 핸들러를 등록해야 한다.

매개변수
paramChannelSendMessageParams 메시지 전송 정보

◆ sendMessage() [3/4]

static void hive.Chat.sendMessage ( DirectSendMessageParams  param)
static

1:1 메시지 전송
특정 대상 사용자에게 메시지를 전송하며, DirectSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다.



전달된 1:1 메시지를 수신하기 위해 Chat.addDirectMessageHandler 이벤트 핸들러를 등록해야 한다.

매개변수
paramDirectSendMessageParams 메시지 전송 정보

◆ sendMessage() [4/4]

static void hive.Chat.sendMessage ( DirectSendMessageParams  param,
onDirectSendMessage  listener 
)
static

1:1 메시지 전송
특정 대상 사용자에게 메시지를 전송하며, DirectSendMessageParams 객체를 생성하여 메시지 전송 정보를 설정할 수 있다.



메시지 전송 결과는 전달된 onDirectSendMessage 콜백을 통해 받을 수 있으며,
전역적으로 메시지를 수신하려면 Chat.addDirectMessageHandler 이벤트 핸들러를 등록해야 한다.

매개변수
paramDirectSendMessageParams 메시지 전송 정보

◆ unblockMember()

static void hive.Chat.unblockMember ( Int64  blockPlayerId,
onUnblockMember  listener 
)
static

멤버 차단 해제
현재 사용자가 차단한 멤버 중 특정 멤버의 차단을 해제한다.


매개변수
blockPlayerId차단을 해제할 멤버의 playerId
listeneronUnblockMember
Copyright © Com2uS Platform Corporation. All Right Reserved. 이용약관 개인정보 처리방침