客戶服務¶

客服是一個系統，您可以在使用遊戲或平台時，針對查詢或問題與代表進行 1:1 聯繫並獲得答案。

聯絡我們¶

1:1 諮詢是由 Hive SDK 提供的客戶服務入口，提供常見問題解答和諮詢選項等功能。諮詢功能不僅在遊戲內可用，還可以在移動和 PC 網站上提供相同的功能。

Hive SDK 提供了一個功能，可以在應用內的網頁視圖中顯示 1:1 查詢。要顯示 1:1 查詢，您必須遵循以下步驟。

開發者實作一個按鈕或 UI 元素，能在應用程式中顯示 1:1 查詢。
當用戶在應用程式中選擇這個按鈕或 UI 元素時，應用程式利用 Hive SDK 認證功能來調用 AuthV4.showInquiry。

呼叫 AuthV4.showInquiry 將顯示由 Hive SDK 提供的查詢螢幕。用戶可以在查詢螢幕上註冊遊戲查詢。

在實施1:1詢問的曝光時，請記住以下幾點。

在用戶註冊查詢時，必須在應用程式 UI 中顯示 Hive PlayerID (CS 代碼)。
用戶即使在訪客登錄狀態下也應能使用它。
顯示客戶服務中心鏈接的規定可能會根據遊戲發行公司而有所不同。
除了 1:1 查詢按鈕外，根據政策不允許顯示應用開發者的電話號碼或電子郵件地址。

這是一個顯示聯絡表單的範例代碼。

UnityC++KotlinJavaSwiftObjective-C虛幻引擎

API 參考: AuthV4.showInquiry

using hive;    
    AuthV4.showInquiry((ResultAPI result) => {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

API 參考: AuthV4 ::showInquiry

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    AuthV4::showInquiry([=](ResultAPI const & result) {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

API 參考: AuthV4.showInquiry

import com.hive.AuthV4;
    import com.hive.ResultAPI;
    AuthV4.showInquiry(object : AuthV4.AuthV4ShowInquiryListener {    
         override fun onAuthV4ShowInquiry(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

API 參考: AuthV4.INSTANCE.showInquiry

import com.hive.AuthV4;    
    import com.hive.ResultAPI;    
    AuthV4.INSTANCE.showInquiry(result -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

API 參考: AuthV4Interface .showInquiry

import HIVEService    
    AuthV4Interface.showInquiry() { result in    
    if result.isSuccess() {    
    // call successful    
    }    
}

API 參考: [ HIVEAuthV4 showInquiry]

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEAuthV4 showInquiry: ^(HIVEResultAPI *result) {    
    if ([result isSuccess]) {    
    // call successful    
    }    
}];

#include "HiveAuthV4.h"

FHiveAuthV4::ShowInquiry(FHiveAuthV4OnShowInquiryDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // 呼叫成功
        }
}));

我的詢問歷史 (Hive 會員 IdP 專屬)¶

在整合 Hive 會員身份提供者時，用戶可以通過「我的查詢歷史」快捷方式快速檢查他們提交的查詢。Hive SDK 提供了一個功能，可以在應用內的網頁視圖中顯示「我的查詢歷史」。要顯示您的查詢歷史，您必須遵循以下步驟。

開發者將在應用程式中實作一個按鈕或 UI 元素，以顯示我的查詢歷史。
當用戶在應用程式中選擇此按鈕或 UI 元素時，應用程式將利用 Hive SDK 認證功能來調用 AuthV4.showMyInquiry。

呼叫 AuthV4.showMyInquiry 將會顯示由 Hive SDK 提供的我的查詢歷史。

如果我的查詢歷史不可用¶

以下是無法調用 AuthV4.showMyInquiry 的情況。

如果用户在应用程序中与 Facebook 或 Google 等其他 IdP 关联后调用 AuthV4.showInquiry 来创建 1:1 查询，而不是 Hive 会员
如果用户在应用程序中未使用任何 IdP 登录时调用 AuthV4.showInquiry 来创建 1:1 查询
如果用户通过网页浏览器访问客户服务页面并创建 1:1 查询

在上述情況 2 和 3 中，當用戶在應用中寫下 1:1 查詢並使用 Hive 會員 IdP 帳戶登錄後，即使調用 AuthV4.showMyInquiry，也無法檢索他們的查詢歷史。

這是一段示範代碼，顯示我的查詢歷史。

UnityC++KotlinJavaSwiftObjective-C虛幻引擎

API 參考: hive.AuthV4 .showMyInquiry

using hive;    
    AuthV4.showMyInquiry((ResultAPI result) => {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

API 參考: AuthV4:: showMyInquiry

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    AuthV4::showMyInquiry([=](ResultAPI const & result) {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

API 參考: AuthV4.showMyInquiry

import com.hive.AuthV4;
    import com.hive.ResultAPI;    
    AuthV4.showMyInquiry(object : AuthV4.AuthV4ShowMyInquiryListener {    
         override fun onAuthV4ShowMyInquiry(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

API 參考: com.hive .AuthV4.showMyInquiry

import com.hive.AuthV4;    
    import com.hive.ResultAPI;    
    AuthV4.INSTANCE.showMyInquiry(result -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

API 參考: AuthV4Interface .showMyInquiry

import HIVEService    
    AuthV4Interface.showMyInquiry() { result in    
    if result.isSuccess() {    
    // call successful    
    }    
}

API 參考: HIVEAuthV4:: showMyInquiry

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEAuthV4 showMyInquiry: ^(HIVEResultAPI *result) {    
    if ([result isSuccess]) {    
    // call successful    
    }    
}];

#include "HiveAuthV4.h"

FHiveAuthV4::ShowMyInquiry(FHiveAuthV4OnShowInquiryDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // 呼叫成功
        }
}));

聊天機器人¶

Hive SDK 提供了一個功能，讓客戶可以在聊天機器人中查詢。

聯絡聊天機器人¶

Hive SDK 提供在應用程式內的網頁視圖中顯示聊天機器人查詢的功能。要顯示聊天機器人查詢，您必須遵循以下步驟。

開發者實現一個按鈕或 UI 元素，可以在應用程式中顯示聊天機器人的詢問。
當用戶在應用程式中選擇這個按鈕或 UI 元素時，應用程式利用 Hive SDK 認證功能來調用 AuthV4.showChatbotInquiry。

這是一個展示聊天機器人查詢的示例代碼。

UnityC++KotlinJavaSwiftObjective-C虛幻引擎

API 參考: hive .AuthV4.showChatbotInquiry

using hive;    
    // 呼叫聊天機器人頁面快捷 API 時承諾以 JSON 格式傳遞的字符串數據    
    String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4.showChatbotInquiry(additionalInfo, (ResultAPI result) => {    
         if (result.isSuccess()) {    
             // 呼叫成功    
         }    
});

API 參考: AuthV4 ::showChatbotInquiry

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    // String data in JSON format promised to be delivered when calling the chatbot page shortcut API    
    string additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4::showChatbotInquiry(additionalInfo, [=](ResultAPI const &result) {    
         if (result.isSuccess()) {    
            // call successful    
         }    
});

API 參考: AuthV4.showChatbotInquiry

import com.hive.AuthV4;
    import com.hive.ResultAPI;
    // 語音助手頁面快捷 API 調用時承諾以 JSON 格式傳遞的字符串數據    
    val additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"    
    AuthV4.showChatbotInquiry(additionalInfo, object : AuthV4.AuthV4ShowChatbotInquiryListener {    
         override fun onAuthV4ShowChatbotInquiry(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // 調用成功    
             }    
         }    
})

API 參考: com.hive .AuthV4.showChatbotInquiry

import com.hive.AuthV4;    
    import com.hive.ResultAPI;    
    // 调用聊天机器人页面快捷 API 时承诺以 JSON 格式提供的数据    
    String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4.INSTANCE.showChatbotInquiry(additionalInfo, result -> {    
         if (result.isSuccess()) {    
             // 调用成功    
         }    
});

API 參考: AuthV4Interface.showChatbotInquiry

import HIVEService    
    // String data in JSON format promised to be delivered when calling the chatbot page shortcut API    
    let additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"    
    AuthV4Interface.showChatbotInquiry(additionalInfo) { result in    
    if result.isSuccess() {    
    // call successful    
    }    
}

API 參考: HIVEAuthV4:: showChatbotInquiry

#import <HIVEService/HIVEService-Swift.h>    
    // 调用聊天机器人页面快捷 API 时承诺交付的 JSON 格式字符串数据    
    NSString *additionalInfo = @"{ \"init_path\":\"hive_sdk_api\" }";    
    [HIVEAuthV4 showChatbotInquiry:additionalInfo handler:^(HIVEResultAPI *result) {    
    if ([result isSuccess]) {    
             // 调用成功    
         }    
}];

#include "HiveAuthV4.h"

// 當調用聊天機器人頁面快捷 API 時承諾的 JSON 格式字符串數據
TSharedPtr<FJsonObject> AdditionalInfoJson = MakeShareable(new FJsonObject);
AdditionalInfoJson->SetStringField(TEXT("init_path"), TEXT("hive_sdk_api"));

FString StrAdditionalInfo;
TSharedRef<TJsonWriter<>> JsonWriter = TJsonWriterFactory<>::Create(&StrAdditionalInfo);
FJsonSerializer::Serialize(AdditionalInfoJson.ToSharedRef(), JsonWriter);

FHiveAuthV4::ShowChatbotInquiry(StrAdditionalInfo, FHiveAuthV4OnShowInquiryDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // 呼叫成功
        }
}));

additionalInfo 是一個字串類型的常數 ("{ \"init_path\":\"hive_sdk_api\" }")，這是顯示聊天機器人頁面時要發送的數據。

Appdelegate 設定 (ios)¶

在聊天機器人中使用的 AppDelegate 是一個定義 iOS 應用程序頂層對象中發生的常見行為（方法）的類，並且在使用 Xcode 項目構建時會自動生成。Hive SDK 以固定豎屏的方式暴露聊天機器人 UI，以方便用戶使用，為了使此功能在 iOS 上正確運作，遊戲引擎的 AppDelegate 類的與屏幕旋轉相關的方法 application(_:supportedInterfaceOrientationsFor:) 必須如下實現。

Objective-cSwift

// 如果游戏引擎是用 Objective-C 制作的，请实现以下 AppDelegate 函数
- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window 
{
    // TODO: 仅限横屏游戏
    return UIInterfaceOrientationMaskLandscape;
    // TODO: 仅限竖屏游戏
    return UIInterfaceOrientationMaskPortrait;
    // TODO: 支持横屏和竖屏的游戏
    return UIInterfaceOrientationMaskAll;
}

// 如果這是一個用 Swift 製作的遊戲引擎，實現以下 AppDelegate 函數
func application(_ application: UIApplication, supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask 
{
    // TODO: 針對僅橫屏的遊戲
    return [.landscape]
    // TODO: 針對僅豎屏的遊戲
    return [.portrait]
    // TODO: 針對支持橫屏和豎屏的遊戲
    return .all
}

上述方法的返回值作为 UIInterfaceOrientationMask 值返回，以应用于游戏。对于仅支持横屏的游戏，它返回横屏；对于仅支持竖屏的游戏，它返回竖屏；对于支持横屏和竖屏的游戏，它返回 横屏和竖屏。

Warning

Unity 引擎已經實現了與螢幕旋轉相關的 AppDelegate 方法，這些方法將在通過 Xcode 專案構建時自動生成。換句話說，如果您正在使用 Unity 開發遊戲，則無需在上面的示例代碼中實現 application(_:supportedInterfaceOrientationsFor:) 方法。

如果您想在 iPad 上以纵向模式显示聊天机器人屏幕，请在 Xcode 中应用以下附加设置，然后进行构建。