跳转至

游戏内外部浏览器调用

从 Hive SDK v4 24.0.0 开始,提供了在游戏中调用外部浏览器的能力。这意味着用户可以在游戏时使用外部浏览器,而无需离开游戏。

游戏内外部浏览器调用功能不仅降低了用户跳出率,还提供了更好的用户体验。

Note

有关更多信息,请参见 Android 自定义标签 和 iOS SFSafariViewController 文档。

使用

关于如何使用游戏内外部浏览器调用功能的说明。

设置功能

可以使用 InAppBrowserParam 设置的功能如下。

特性 内容 默认设置
NavigationColor 指定顶部导航区域的颜色。 操作系统默认颜色
ButtonColor (仅支持iOS) 指定顶部导航区域按钮的颜色。 操作系统默认颜色
UrlBarHiding 当发生滚动事件时,顶部URL曝光区域被隐藏。 true
AutoRedirectToExternalBrowser (仅限Android) 如果终端默认应用中设置的浏览器应用不受支持,则自动支持外部浏览器连接。 true

示例代码

设置使用InAppBrowserParam的函数的示例代码如下。

using hive;

InAppBrowserParam param = new InAppBrowserParam.Builder("https://developers.withhive.com/")
                                                                        .setNavigationColor("#3891f0")
                                                                        .setButtonColor("#ffffff")
                                                                        .setUrlBarHiding(true)
                                                                        .setAutoRedirectToExternalBrowser(true)
                                                                        .build();

    PlatformHelper.showInAppBrowser(param, (ResultAPI result) => {
            if (result.isSuccess()) {
                    // API 调用成功
            }
    });
    #include <HIVE_SDK_Plugin/HIVE_CPP.h>
    using namespace std;
    using namespace hive;

    InAppBrowserParam *param = new InAppBrowserParam("https://developers.withhive.com/");
    param->navigationColor = "3891f0";
    param->buttonColor = "#ffffff";
    param->urlBarHiding = true;
    param->autoRedirectToExternalBrowser = true;

    PlatformHelper::showInAppBrowser(*param, [=](ResultAPI const & result) {
            if (result.isSuccess()) {
                    // API 调用成功
            }
    });
    import com.hive.PlatformHelper;
    import com.hive.ResultAPI;

    PlatformHelper.InAppBrowserParam param = new PlatformHelper.InAppBrowserParam.Builder("https://developers.withhive.com/")
                                    .setNavigationColor("#3891f0")
                                    .setUrlBarHiding(true)
                                    .setAutoRedirectToExternalBrowser(true)
                                    .build();

    PlatformHelper.showInAppBrowser(param, result -> {
            if (result.isSuccess()) {
                    // API 调用成功
            }

    });
import com.hive.PlatformHelper
import com.hive.ResultAPI

val param = PlatformHelper.InAppBrowserParam.Builder("https://developers.withhive.com/")
                                        .setNavigationColor("#3891f0")
                                        .setUrlBarHiding(true)
                                        .setAutoRedirectToExternalBrowser(true)
                                        .build()

PlatformHelper.showInAppBrowser(param, object : PlatformHelper.InAppBrowserListener {
        override fun onInAppBrowser(result: ResultAPI) {
                if (result.isSuccess) {
                        // API 调用成功
                }
        }
})
import HIVEService

let inAppBrowserParam = InAppBrowserParam.Builder(url: "https://developers.withhive.com/")
                                                .setNavigationColor("#3891f0")
                                                .setButtonColor("#ffffff")
                                                .setUrlBarHiding(true)
                                                .setAutoRedirectToExternalBrowserbuild(true)
                                                .build()

PlatformHelperInterface.showInAppBrowser(inAppBrowserParam) { resultAPI in
    if result.isSuccess() {
                // API 调用成功
        }
};
#import <HIVEService/HIVEService-Swift.h>

HiveInAppBrowserParamBuilder *builder = [[HiveInAppBrowserParamBuilder alloc] initWithUrl: @"https://developers.withhive.com/"];
HiveInAppBrowserParam *inAppBrowserParam = [[[[[builder setNavigationColor: @"#3891f0"]
                                                                                                                    setButtonColor: @"#ffffff"]
                                                                                                                    setUrlBarHiding: YES]
                                                                                                                    setAutoRedirectToExternalBrowser: YES]
                                                                                                                    build];

[HIVEPlatformHelper showInAppBrowser: inAppBrowserParam handler: ^(HIVEResultAPI *result) {
        if ([result isSuccess]) {
                // API 调用成功
        }
}];