Hive는 별도의 개발이나 게임 업데이트 없이도 유저에게 전하고자 하는 내용을 간단하게 HTML 페이지로 보여줄 수 있는 웹뷰를 제공합니다. 이런 웹뷰를 Hive 웹뷰 혹은 소셜 웹뷰라고 부릅니다. 게임에서 API를 호출했을 때 특정 웹뷰로 연결되도록 설정하지 않은 경우에는 Hive 연결 시 유저 프로필을 기본으로 호출합니다.
Hive는 Hive 웹뷰 기능으로 다음 목록에 나열된 Hive 페이지를 제공합니다. Hive 페이지를 표시하려면 페이지 종류를 hiveDialogType 파라미터에 담아 SocialHive 클래스의 showHiveDialog() 메서드를 호출하세요. Hive 페이지별 파라미터 값은 다음과 같습니다.
1:1 문의하기
다음은 Hive 페이지 중 1:1 문의하기 페이지를 웹뷰로 표시하는 예제 코드입니다.
API Reference: hive.SocialHive.showHiveDialog
|
1 2 3 4 5 6 7 8 9 10 11 12 |
using hive; HiveDialogType dialogType = HiveDialogType.INQUIRY; // vid 정보가 필요한 Hive 웹뷰를 표시할 때는 값 필요 String vid = ""; SocialHive.showHiveDialog(dialogType, vid, (ResultAPI result) => { if (result.isSuccess()) { // 호출 성공 } }); |
API Reference: SocialHive::showHiveDialog
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
#include <HIVE_SDK_Plugin/HIVE_CPP.h> using namespace std; using namespace hive; HiveDialogType dialogType = HiveDialogType::INQUIRY; // vid 정보가 필요한 Hive 웹뷰를 표시할 때는 값 필요 string vid = ""; SocialHive::showHiveDialog(dialogType, vid, [=](ResultAPI result) { if (result.isSuccess()) { // 호출 성공 } }); |
API Reference: SocialHive.showHiveDialog
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
import com.hive.SocialHive import com.hive.ResultAPI val dialogType = SocialHive.HiveDialogType.INQUIRY // vid 정보가 필요한 Hive 웹뷰를 표시할 때는 값 필요 val vid = "" SocialHive.showHiveDialog(dialogType, vid, object : SocialHive.ShowHiveDialogListener { override fun onShowHiveDialog(result: ResultAPI) { if (result.isSuccess) { // 호출 성공 } } }) |
API Reference: com.hive.SocialHive.showHiveDialog
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
import com.hive.SocialHive; import com.hive.ResultAPI; SocialHive.HiveDialogType dialogType = SocialHive.HiveDialogType.INQUIRY; // vid 정보가 필요한 Hive 웹뷰를 표시할 때는 값 필요 String vid = ""; SocialHive.INSTANCE.showHiveDialog(dialogType, vid, result -> { if (result.isSuccess()) { // 호출 성공 } }); |
API Reference: SocialHiveInterface.showHiveDialog
|
1 2 3 4 5 6 7 8 9 10 11 12 |
import HIVEService let dialogType = DialogType.inquiry // vid 정보가 필요한 Hive 웹뷰를 표시할 때는 값 필요 let vid = "" SocialHiveInterface.showHiveDialog(dialogType, vid: vid) { result in if result.isSuccess() { // 호출 성공 } } |
API Reference: HIVESocialHive::showHiveDialog:vid:handler:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
#import <HIVEService/HIVEService-Swift.h> HIVEDialogType dialogType = HIVEDialogTypeInquiry; // vid 정보가 필요한 Hive 웹뷰를 표시할 때는 값 필요 NSString *vid = @""; [HIVESocialHive showHiveDialog: dialogType vid: vid handler: ^(HIVEResultAPI *result) { if ([result isSuccess]) { // 호출 성공 } }]; |
내 문의 내역 바로가기
Hive 고객센터는 Hive 멤버십 연동 유저에게 본인이 접수한 문의 내역을 바로 확인할 수 있는 기능을 제공합니다. HiveDialogType을 파라미터로 MYINQUIRY를 추가하여 내 문의 내역 바로 가기를 적용해보세요. 유저가 게임에 대한 문의 사항을 보다 간편하게 해결할 수 있는 환경이 구현됩니다. 다만, Hive 모바일이나 웹 사이트를 통해 문의한 경우에는 Hive 멤버십 로그인 여부를 확인할 수 없기 때문에 Hive ID와 CS Code(PlayerID)를 입력해도 앱에서는 노출되지 않습니다.
챗봇 문의하기
챗봇 문의하기를 노출하기 위해서는 SocialHive 클래스의 showHiveDialog() 메서드를 호출합니다.
| Argument | Type | Description |
|---|---|---|
| additionalInfo | string | 챗봇 페이지 노출 시 함께 전달할 데이터"{ \"init_path\":\"hive_sdk_api\" }"로 고정하며, 추가 전달할 값이 필요한 경우 컴투스플랫폼 AI개발팀과 협의 |
다음은 챗봇 문의하기를 노출하는 예제 코드입니다.
API Reference: Unity®
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
using hive; HiveDialogType dialogType = HiveDialogType.CHATBOT; String vid = ""; // 챗봇 페이지 바로가기 API 호출시 전달하기로한 약속한 JSON 형식의 String 데이터 String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"; SocialHive.showHiveDialog (dialogType, vid, additionalInfo, (ResultAPI result) => { if (result.isSuccess()) { // 호출 성공 } }); |
API Reference: C++
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
#include <HIVE_SDK_Plugin/HIVE_CPP.h> using namespace std; using namespace hive; HiveDialogType dialogType = HiveDialogType::CHATBOT; string vid = ""; // 챗봇 페이지 바로가기 API 호출시 전달하기로한 약속한 JSON 형식의 String 데이터 string additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"; SocialHive::showHiveDialog (dialogType, vid, additionalInfo, [=](ResultAPI const &result) { if (result.isSuccess()) { // 호출 성공 } }); |
API Reference: Kotlin
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
import com.hive.SocialHive import com.hive.ResultAPI val dialogType = SocialHive.HiveDialogType.CHATBOT val vid = "" // 챗봇 페이지 바로가기 API 호출시 전달하기로한 약속한 JSON 형식의 String 데이터 val additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }" SocialHive.showHiveDialog(dialogType, vid, additionalInfo, object : SocialHive.ShowHiveDialogListener { override fun onShowHiveDialog(result: ResultAPI) { if (result.isSuccess) { // 호출 성공 } } }) |
API Reference: Java
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
import com.hive.SocialHive; import com.hive.ResultAPI; SocialHive.HiveDialogType dialogType = SocialHive.HiveDialogType.CHATBOT; String vid = ""; // 챗봇 페이지 바로가기 API 호출시 전달하기로한 약속한 JSON 형식의 String 데이터 String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"; SocialHive.INSTANCE.showHiveDialog(dialogType, vid, additionalInfo, result -> { if (result.isSuccess()) { // 호출 성공 } }); |
API Reference: Swift
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
import HIVEService let dialogType = DialogType.chatbot let vid = "" // 챗봇 페이지 바로가기 API 호출시 전달하기로한 약속한 JSON 형식의 String 데이터 let additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }" SocialHiveInterface.showHiveDialog(dialogType, vid: vid, additionalInfo: additionalInfo) { result in if result.isSuccess() { // 호출 성공 } } |
API Reference: Objective-C
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
#import <HIVEService/HIVEService-Swift.h> HIVEDialogType dialogType = HIVEDialogTypeChatbot; NSString *vid = @""; // 챗봇 페이지 바로가기 API 호출시 전달하기로한 약속한 JSON 형식의 String 데이터 NSString *additionalInfo = @"{ \"init_path\":\"hive_sdk_api\" }"; [HIVESocialHive showHiveDialog: dialogType vid: vid additionalInfo: additionalInfo handler: ^(HIVEResultAPI *result) { if ([result isSuccess]) { // 호출 성공 } }]; |