客户服务¶

客户服务是一个系统，您可以在使用游戏或平台时就出现的询问或问题与代表进行 1:1 联系并获得答案。

联系我们¶

1:1咨询是由Hive SDK提供的客户服务门户，提供常见问题解答和咨询选项等功能。咨询功能不仅在游戏内可用，还可以在移动和PC网站上提供相同的功能。

Hive SDK 提供了一项功能，可以在应用内的网页视图中公开 1:1 查询。要公开 1:1 查询，您必须遵循以下步骤。

开发者实现一个按钮或用户界面元素，以便在应用中公开1:1查询。
当用户在应用中选择此按钮或用户界面元素时，应用利用Hive SDK身份验证功能调用AuthV4.showInquiry。

调用 AuthV4.showInquiry 将显示由 Hive SDK 提供的查询屏幕。用户可以在查询屏幕上注册游戏查询。

在实施1:1咨询的曝光时，请记住以下几点。

用户在注册咨询时所需的 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 会员 IdP 时，用户可以通过“我的查询历史”快捷方式快速查看他们提交的查询。Hive SDK 提供了一个功能，可以在应用内的网页视图中显示“我的查询历史”。要显示您的查询历史，您必须按照以下步骤操作。

开发者将在应用中实现一个按钮或用户界面元素，以显示我的查询历史。
当用户在应用中选择此按钮或用户界面元素时，应用将利用 Hive SDK 认证功能调用 AuthV4.showMyInquiry。

调用 AuthV4.showMyInquiry 将暴露由 Hive SDK 提供的我的查询历史。

如果我的查询历史不可用¶

以下是无法调用 AuthV4.showMyInquiry 的情况。

如果用户在应用中链接到其他身份提供者（如 Facebook 或 Google）而不是 Hive 会员时调用 AuthV4.showInquiry 创建 1:1 查询
如果用户在应用中未通过任何身份提供者登录时调用 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 提供了在应用内的网页视图中显示聊天机器人询问的功能。要显示聊天机器人询问，您必须遵循以下步骤。

开发者实现一个按钮或用户界面元素，以便在应用中展示聊天机器人查询。
当用户在应用中选择此按钮或用户界面元素时，应用利用 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;    
    // 调用聊天机器人页面快捷 API 时承诺以 JSON 格式交付的字符串数据    
    string additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4::showChatbotInquiry(additionalInfo, [=](ResultAPI const &result) {    
         if (result.isSuccess()) {    
            // 调用成功    
         }    
});

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;    
    // String data in JSON format promised to be delivered when calling the chatbot page shortcut API    
    String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4.INSTANCE.showChatbotInquiry(additionalInfo, result -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

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()) {
                // Call succeeded
        }
}));

additionalInfo 是一个字符串类型的常量 ("{ \"init_path\":\"hive_sdk_api\" }")，它是在聊天机器人页面显示时要发送的数据。

Appdelegate 设置 (ios)¶

在聊天机器人中使用的AppDelegate是一个类，它定义了在iOS应用程序的顶层对象中发生的常见行为（方法），并且在使用Xcode项目构建时会自动生成。Hive SDK以固定竖屏的方式公开聊天机器人UI，以方便用户使用，为了使此功能在iOS上正常工作，游戏引擎的AppDelegate类的与屏幕旋转相关的方法application(_:supportedInterfaceOrientationsFor:)必须如下实现。

Objective-c斯威夫特

// 如果游戏引擎是用 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 中应用以下附加设置，然后进行构建。