HIve Chat

더 자세히 ...

클래스
class	Chat
	HiveChat은 실시간, 그룹, 1:1 채팅, 유저 간 차단 기능 등 게임에서 원활한 채팅을 할 수 있도록 필요한 핵심 기능을 제공하기 때문에 유저 간 협력을 증가시켜 게임 플레이 만족도를 높일 수 있습니다. 더 자세히 ...

class	Channel
	채팅 채널 정보 더 자세히 ...

class	ChannelPage
	채널 조회 페이지 정보 더 자세히 ...

class	Member
	채널 멤버 정보 더 자세히 ...

class	BlockMember
	차단된 사용자 정보 더 자세히 ...

class	CreateChannelParams
	채널 생성 파라미터 더 자세히 ...

class	GetChannelsParams
	채널 목록 조회 파라미터 더 자세히 ...

class	EnterChannelParams
	채널 입장 파라미터 더 자세히 ...

class	ChannelSendMessageParams
	채널 메시지 전송 파라미터 더 자세히 ...

class	DirectSendMessageParams
	1:1 메시지 전송 파라미터 더 자세히 ...

class	ChannelMessageListQueryParams
	채널 대화 이력 조회 파라미터 더 자세히 ...

class	EnteredMember
	입장 멤버 정보 더 자세히 ...

class	ExitedMember
	퇴장 멤버 정보 더 자세히 ...

class	DeletedChannel
	삭제된 채널 정보 더 자세히 ...

class	ChannelNoticeMessage
	채널 공지 메시지 정보 더 자세히 ...

class	ChannelMessage
	채널 메시지 정보 더 자세히 ...

class	DirectMessage
	1:1 메시지 정보 더 자세히 ...

class	NoticeMessage
	유저 대상 공지 메시지 정보 더 자세히 ...

class	ChannelMessageListQueryResponse
	채널 대화 이력 정보 더 자세히 ...

class	TranslationData
	메시지 번역 결과 더 자세히 ...

class	ChannelListener
	채널 이벤트 리스너 더 자세히 ...

class	DirectMessageListener
	1:1 메시지 리스너 더 자세히 ...

class	UserListener
	유저 이벤트 리스너 더 자세히 ...

class	ConnectionListener
	연결 리스너 더 자세히 ...

class	CustomDataListener
	커스텀 데이터 리스너 더 자세히 ...

열거형 타입
enum class	ChannelType
	채팅 채널 타입 정보 더 자세히 ...

enum class	SortType
	채널 정렬 타입 정보 더 자세히 ...

함수
static void	Chat::createChannel (CreateChannelParams const &params, onCreateChannel listener)
	채널 생성 더 자세히 ...

static void	Chat::getChannels (GetChannelsParams const *params, onGetChannels listener)
	채널 목록 조회 접근 가능한 채널 목록을 조회합니다. 더 자세히 ...

static void	Chat::getChannelInfo (const char *channelId, onGetChannelInfo listener)
	채널 정보 조회 채널 ID를 입력받아, 해당 채널의 정보를 조회합니다. 더 자세히 ...

static void	Chat::getChannelMembers (const char *channelId, onGetChannelMembers listener)
	채널 멤버 조회 채널 ID를 입력받아, 해당 채널의 멤버 목록을 조회합니다. 더 자세히 ...

static void	Chat::deleteChannel (const char *channelId, onDeleteChannel listener)
	채널 삭제 채널 ID를 입력받아, 해당 채널을 삭제합니다. 더 자세히 ...

static void	Chat::enterChannel (EnterChannelParams const &params, onEnterChannel listener)
	채널 입장 채널 ID를 입력받아, 채널에 접속합니다. 더 자세히 ...

static void	Chat::exitChannel (const char *channelId, onExitChannel listener)
	채널 퇴장 채널 ID를 입력받아, 해당 채널에서 퇴장합니다. 더 자세히 ...

static void	Chat::getChannelsByUser (onGetChannelsByUser listener)
	참여중인 채널 목록 조회 참여중인 채널 목록을 조회합니다. 더 자세히 ...

static void	Chat::getBlockMembers (onGetBlockMembers listener)
	차단된 사용자 목록 조회 차단된 사용자 목록을 조회합니다. 더 자세히 ...

static void	Chat::blockMember (int64_t blockPlayerId, onBlockMember listener)
	사용자 차단 사용자 ID를 입력받아, 해당 사용자를 차단합니다. 더 자세히 ...

static void	Chat::unblockMember (int64_t blockPlayerId, onUnblockMember listener)
	사용자 차단 해제 사용자 ID를 입력받아, 해당 사용자의 차단을 해제합니다. 더 자세히 ...

static void	Chat::translate (TranslateParams const &params, onTranslate listener)
	메시지 번역 요청 targetLanguage와 번역할 메시지를 입력받아, 해당 메시지를 번역합니다. 더 자세히 ...

static void	Chat::connect (const char *extraData, onResult listener)
	채팅서버에 연결 (더 이상 사용되지 않음) 이 메서드는 더 이상 사용을 권장하지 않으며, 향후 버전에서 제거될 예정입니다. 더 자세히 ...

static void	Chat::connect (onConnect listener)
	채팅서버에 연결 채팅서버에 연결을 시도합니다. 더 자세히 ...

static void	Chat::reconnect (onReconnect listener)
	채팅 서버 재 연결 Hive 채팅 서버와 재연결 합니다. 더 자세히 ...

static void	Chat::disconnect (onDisconnect listener)
	채팅서버 연결 해제 채팅서버와의 연결을 해제합니다. 더 자세히 ...

static void	Chat::sendMessageWithChannelSendMessageParams (ChannelSendMessageParams const &params)
	채널 메시지 전송 채널 ID와 메시지를 입력받아, 해당 채널에 메시지를 전송합니다. 더 자세히 ...

static void	Chat::sendMessageWithChannelSendMessageParams (ChannelSendMessageParams const &params, onChannelSendMessage listener)
	채널 메시지 전송 채널 ID와 메시지를 입력받아, 해당 채널에 메시지를 전송합니다. 더 자세히 ...

static void	Chat::sendMessageWithDirectSendMessageParams (DirectSendMessageParams const &params)
	1:1 메시지 전송 수신자 ID와 메시지를 입력받아, 해당 사용자에게 메시지를 전송합니다. 더 자세히 ...

static void	Chat::sendMessageWithDirectSendMessageParams (DirectSendMessageParams const &params, onDirectSendMessage listener)
	1:1 메시지 전송 수신자 ID와 메시지를 입력받아, 해당 사용자에게 메시지를 전송합니다. 더 자세히 ...

static void	Chat::addChannelListener (const char uniqueKey, ChannelListener listener)
	채널 리스너 등록 채널 이벤트를 수신하기 위한 리스너를 등록합니다. 더 자세히 ...

static void	Chat::addDirectMessageListener (const char uniqueKey, DirectMessageListener listener)
	1:1 메시지 리스너 등록 1:1 메시지를 수신하기 위한 리스너를 등록합니다. 더 자세히 ...

static void	Chat::addUserListener (const char uniqueKey, UserListener listener)
	유저 리스너 등록 유저 이벤트를 수신하기 위한 리스너를 등록합니다. 더 자세히 ...

static void	Chat::addConnectionListener (const char uniqueKey, ConnectionListener listener)
	연결 리스너 등록 채팅서버 연결 상태를 수신하기 위한 리스너를 등록합니다. 더 자세히 ...

static void	Chat::addCustomDataListener (const char uniqueKey, CustomDataListener listener)
	커스텀 데이터 리스너 등록 더 자세히 ...

static void	Chat::removeChannelListener (const char *uniqueKey)
	채널 리스너 제거 등록된 채널 리스너를 제거합니다. 더 자세히 ...

static void	Chat::removeDirectMessageListener (const char *uniqueKey)
	1:1 메시지 리스너 제거 등록된 1:1 메시지 리스너를 제거합니다. 더 자세히 ...

static void	Chat::removeUserListener (const char *uniqueKey)
	유저 리스너 제거 등록된 유저 이벤트 리스너를 제거합니다. 더 자세히 ...

static void	Chat::removeConnectionListener (const char *uniqueKey)
	연결 리스너 제거 등록된 연결 리스너를 제거합니다. 더 자세히 ...

static void	Chat::removeCustomDataListener (const char *uniqueKey)
	커스텀 데이터 리스너 제거 더 자세히 ...

static bool	Chat::isConnected ()
	소켓 연결 상태 확인 현재 소켓이 연결되어 있는지 확인합니다. 더 자세히 ...

상세한 설명

HIve Chat

열거형 타입 문서화

◆ ChannelType

enum class ChannelType

strong

채팅 채널 타입 정보

◆ SortType

enum class SortType

strong

채널 정렬 타입 정보

함수 문서화

◆ addChannelListener()

static void Chat::addChannelListener	(	const char *	uniqueKey,
		ChannelListener *	listener
	)

static

채널 리스너 등록
채널 이벤트를 수신하기 위한 리스너를 등록합니다.

등록된 리스너는 채널 이벤트(메시지, 공지메시지, 채널 접속 알림, 채널 퇴장 알림, 채널 삭제 알림)가 발생할 때마다 이벤트를 수신합니다.

Since: 4.25.0.0

◆ addConnectionListener()

static void Chat::addConnectionListener	(	const char *	uniqueKey,
		ConnectionListener *	listener
	)

static

연결 리스너 등록
채팅서버 연결 상태를 수신하기 위한 리스너를 등록합니다.

등록된 리스너는 채팅서버 연결 상태가 변경될 때마다 이벤트를 수신합니다.

Since: 4.25.0.0

◆ addCustomDataListener()

static void Chat::addCustomDataListener	(	const char *	uniqueKey,
		CustomDataListener *	listener
	)

static

커스텀 데이터 리스너 등록

Since: 4.25.4.0

◆ addDirectMessageListener()

static void Chat::addDirectMessageListener	(	const char *	uniqueKey,
		DirectMessageListener *	listener
	)

static

1:1 메시지 리스너 등록
1:1 메시지를 수신하기 위한 리스너를 등록합니다.

등록된 리스너는 1:1 메시지가 발생할 때마다 이벤트를 수신합니다.

Since: 4.25.0.0

◆ addUserListener()

static void Chat::addUserListener	(	const char *	uniqueKey,
		UserListener *	listener
	)

static

유저 리스너 등록
유저 이벤트를 수신하기 위한 리스너를 등록합니다.

등록된 리스너는 1:1 메시지, 공지메시지 이벤트가 발생할 때마다 이벤트를 수신합니다.

Since: 4.25.0.0

◆ blockMember()

static void Chat::blockMember	(	int64_t	blockPlayerId,
		onBlockMember	listener
	)

static

사용자 차단
사용자 ID를 입력받아, 해당 사용자를 차단합니다.

사용자 차단에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ connect() [1/2]

static void Chat::connect	(	const char *	extraData,
		onResult	listener
	)

static

채팅서버에 연결 (더 이상 사용되지 않음)
이 메서드는 더 이상 사용을 권장하지 않으며, 향후 버전에서 제거될 예정입니다.

대신 connect(onResult)를 사용하세요

잘못된 코드:: 4.25.2.0 버전부터 사용되지 않음.

참고: connect(onResult)

Since: 4.25.0.0

◆ connect() [2/2]

static void Chat::connect ( onConnect listener )

static

채팅서버에 연결
채팅서버에 연결을 시도합니다.

연결에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.2.0

◆ createChannel()

static void Chat::createChannel	(	CreateChannelParams const &	params,
		onCreateChannel	listener
	)

static

채널 생성

채널을 생성합니다.
채널명, 최대 인원수, 타입을 지정할수 있으며, PUBLIC이 아니라면 비밀번호 또한 함께 지정해야합니다.
채널 생성에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ deleteChannel()

static void Chat::deleteChannel	(	const char *	channelId,
		onDeleteChannel	listener
	)

static

채널 삭제
채널 ID를 입력받아, 해당 채널을 삭제합니다.

채널 삭제에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ disconnect()

static void Chat::disconnect ( onDisconnect listener )

static

채팅서버 연결 해제
채팅서버와의 연결을 해제합니다.

연결 해제에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ enterChannel()

static void Chat::enterChannel	(	EnterChannelParams const &	params,
		onEnterChannel	listener
	)

static

채널 입장
채널 ID를 입력받아, 채널에 접속합니다.

공개(PUBLIC)채널이 아닌 경우, 비밀번호를 함께 입력해야합니다.
채널 입장에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ exitChannel()

static void Chat::exitChannel	(	const char *	channelId,
		onExitChannel	listener
	)

static

채널 퇴장
채널 ID를 입력받아, 해당 채널에서 퇴장합니다.

채널 퇴장에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ getBlockMembers()

static void Chat::getBlockMembers ( onGetBlockMembers listener )

static

차단된 사용자 목록 조회
차단된 사용자 목록을 조회합니다.

차단된 사용자 목록에는 차단된 사용자의 ID와 차단시간이 포함됩니다.
차단된 사용자 목록 조회에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ getChannelInfo()

static void Chat::getChannelInfo	(	const char *	channelId,
		onGetChannelInfo	listener
	)

static

채널 정보 조회
채널 ID를 입력받아, 해당 채널의 정보를 조회합니다.

조회 결과로 해당 채널의 정보와, 채널에 참여중인 멤버들의 목록이 전달됩니다.

Since: 4.25.0.0

◆ getChannelMembers()

static void Chat::getChannelMembers	(	const char *	channelId,
		onGetChannelMembers	listener
	)

static

채널 멤버 조회
채널 ID를 입력받아, 해당 채널의 멤버 목록을 조회합니다.

조회 결과로 해당 채널의 멤버 목록이 전달됩니다.

Since: 4.25.0.0

◆ getChannels()

static void Chat::getChannels	(	GetChannelsParams const *	params,
		onGetChannels	listener
	)

static

채널 목록 조회
접근 가능한 채널 목록을 조회합니다.

채널 타입, 채널명, 페이지 순서, 페이지 사이즈, 페이지 번호를 지정할 수 있습니다.
채널 목록 조회에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ getChannelsByUser()

static void Chat::getChannelsByUser ( onGetChannelsByUser listener )

static

참여중인 채널 목록 조회
참여중인 채널 목록을 조회합니다.

채널 목록 조회에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ isConnected()

static bool Chat::isConnected ( )

static

소켓 연결 상태 확인
현재 소켓이 연결되어 있는지 확인합니다.

Since: 4.25.0.0

◆ reconnect()

static void Chat::reconnect ( onReconnect listener )

static

채팅 서버 재 연결
Hive 채팅 서버와 재연결 합니다.

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

Since: 4.25.2.0

◆ removeChannelListener()

static void Chat::removeChannelListener ( const char * uniqueKey )

static

채널 리스너 제거
등록된 채널 리스너를 제거합니다.

Since: 4.25.0.0

◆ removeConnectionListener()

static void Chat::removeConnectionListener ( const char * uniqueKey )

static

연결 리스너 제거
등록된 연결 리스너를 제거합니다.

Since: 4.25.0.0

◆ removeCustomDataListener()

static void Chat::removeCustomDataListener ( const char * uniqueKey )

static

커스텀 데이터 리스너 제거

Since: 4.25.4.0

◆ removeDirectMessageListener()

static void Chat::removeDirectMessageListener ( const char * uniqueKey )

static

1:1 메시지 리스너 제거
등록된 1:1 메시지 리스너를 제거합니다.

Since: 4.25.0.0

◆ removeUserListener()

static void Chat::removeUserListener ( const char * uniqueKey )

static

유저 리스너 제거
등록된 유저 이벤트 리스너를 제거합니다.

Since: 4.25.0.0

◆ sendMessageWithChannelSendMessageParams() [1/2]

static void Chat::sendMessageWithChannelSendMessageParams ( ChannelSendMessageParams const & params )

static

채널 메시지 전송
채널 ID와 메시지를 입력받아, 해당 채널에 메시지를 전송합니다.

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

Since: 4.25.0.0

◆ sendMessageWithChannelSendMessageParams() [2/2]

static void Chat::sendMessageWithChannelSendMessageParams	(	ChannelSendMessageParams const &	params,
		onChannelSendMessage	listener
	)

static

채널 메시지 전송
채널 ID와 메시지를 입력받아, 해당 채널에 메시지를 전송합니다.

메시지 전송에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ sendMessageWithDirectSendMessageParams() [1/2]

static void Chat::sendMessageWithDirectSendMessageParams ( DirectSendMessageParams const & params )

static

1:1 메시지 전송
수신자 ID와 메시지를 입력받아, 해당 사용자에게 메시지를 전송합니다.

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

Since: 4.25.0.0

◆ sendMessageWithDirectSendMessageParams() [2/2]

static void Chat::sendMessageWithDirectSendMessageParams	(	DirectSendMessageParams const &	params,
		onDirectSendMessage	listener
	)

static

1:1 메시지 전송
수신자 ID와 메시지를 입력받아, 해당 사용자에게 메시지를 전송합니다.

메시지 전송에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

◆ translate()

static void Chat::translate	(	TranslateParams const &	params,
		onTranslate	listener
	)

static

메시지 번역 요청
targetLanguage와 번역할 메시지를 입력받아, 해당 메시지를 번역합니다.

하나의 메시지를 여러 언어로 번역할 수 있습니다.

Since: 4.25.4.0

◆ unblockMember()

static void Chat::unblockMember	(	int64_t	blockPlayerId,
		onUnblockMember	listener
	)

static

사용자 차단 해제
사용자 ID를 입력받아, 해당 사용자의 차단을 해제합니다.

사용자 차단 해제에 대한 결과는 listener를 통해 전달됩니다.

Since: 4.25.0.0

HIVE SDK for C++

클래스

열거형 타입

함수

상세한 설명

열거형 타입 문서화

◆ ChannelType

◆ SortType

함수 문서화

◆ addChannelListener()

◆ addConnectionListener()

◆ addCustomDataListener()

◆ addDirectMessageListener()

◆ addUserListener()

◆ blockMember()

◆ connect() [1/2]

◆ connect() [2/2]

◆ createChannel()

◆ deleteChannel()

◆ disconnect()

◆ enterChannel()

◆ exitChannel()

◆ getBlockMembers()

◆ getChannelInfo()

◆ getChannelMembers()

◆ getChannels()

◆ getChannelsByUser()

◆ isConnected()

◆ reconnect()

◆ removeChannelListener()

◆ removeConnectionListener()

◆ removeCustomDataListener()

◆ removeDirectMessageListener()

◆ removeUserListener()

◆ sendMessageWithChannelSendMessageParams() [1/2]

◆ sendMessageWithChannelSendMessageParams() [2/2]

◆ sendMessageWithDirectSendMessageParams() [1/2]

◆ sendMessageWithDirectSendMessageParams() [2/2]

◆ translate()

◆ unblockMember()