Embed >

集成嵌入SDK

本章节介绍集成now.gg嵌入（Embed）SDK的步骤。

要集成now.gg嵌入SDK：

将嵌入SDK添加到您的网站。
在Iframe中启动游戏。
此外，您可以使用下一个章节集成嵌入高级功能。

重要信息

确保您的游戏已部署在测试或生产环境，并且您已获得用于嵌入的游戏链接。
您可以按照以下链接创建发布并部署您的应用程序：
- 测试发布
- 生产发布

1. 添加嵌入SDK

第一步是将嵌入SDK添加到您的网站。

要将now.gg嵌入SDK添加到您的网站，请在脚本标签中添加SDK资源的JavaScript，如下所示：

<script type="text/javascript" src="https://cdn.now.gg/external/sdk/ifp-sdk-1.0.0.min.js"></script>

2. 在Iframe中启动游戏

在添加了now.gg嵌入SDK资源后，您可以使用now.gg嵌入功能初始化SDK，以在您的网站上嵌入游戏。

操作步骤如下：

首先定义 iframeParentElement，appEventCallbackFunction，和 sdkEventCallbackFunction。
接下来，使用必要的参数调用 NowIfp 类的 init 函数，以启动云游戏，如下所示：

const iframeParentElement = document.getElementById("your_iframe_element");

// 用于处理从Android应用发送的事件的回调函数。
const appEventCallbackFunction = (event) => {
    console.log(event.name); 
    console.log(event.data);
    // 于此进行基于事件的处理
}; 

// 用于处理javascript SDK事件的回调函数。
const sdkEventCallbackFunction = (event) => {
    console.log(event.name); 
    console.log(event.msg);
    // 于此进行基于事件的处理
}; 


NowIfp.init({
    clientId: <"your_clientId"> ,
    appId: <"your_production_appId/your_test_track_appId"> , \\ appId 示例 - 测试环境: "1234_t1" | 生产环境: "1234"
    iframeParentElement: iframeParentElement,
    customData: {} // 用于应用特定的自定义处理
    appLaunchData: {
        // 传递启动参数给Iframe，它将被序列化并在launch intent传给应用。
        [key]: [value]
    } 
    appEventCallback: appEventCallbackFunction,
    sdkEventCallback: sdkEventCallbackFunction,
});

获取您的appId

使用本节内容，您可以在nowStudio中找到您的 appId。

重要信息

appId 是您的应用程序在nowStudio中的唯一标识符。
nowStudio会为您的应用程序在测试和生产环境中生成不同的 appId。
- 在测试环境, 只有在应用程序部署后，才能看到 appId。
- 在生产环境, appId 也会在您添加应用程序后在应用详情章节中显示。

1. 测试环境的appId

要查找测试环境的appId：
导航到所有应用（All Apps）> 选择您的应用（Select your app）> 测试环境（Test Track）
- appId 列在线上测试发布（live test release）中，如下所示：

2. 生产环境的appId

要查找生产环境的appId：
导航到所有应用（All Apps）> 选择您的应用（Select your app）> 发布（Release）
- appId 列在线上生产发布（live production release）中，如下所示：

参数

参数	类型	是否必需	概要
clientId	string	是	唯一的客户端标识符。
appId	string	是	在nowStudio上与您的应用程序/游戏关联的App ID。会为生产和测试环境生成不同的appId。如 – 生产appId：“1234”。测试appId：“1234_t1”。
iframeParentElement	element	是	用于嵌入播放器渲染的iframeParentElement。
customData	object	否	您希望传递给now.gg后端的任何应用特定数据。
appLaunchData	object	否	作为应用launch intent extras发送的额外数据。- 参考 – 定义appLaunchData 章节。
appEventCallback	function	否	用于处理应用相关事件的回调函数。参考 – 在Iframe中启动游戏章节。
sdkEventCallback	function	否	用于处理SDK相关事件的回调函数。参考 – 在Iframe中启动游戏章节。

您的游戏现在已嵌入到您的网页中，由now.gg云提供支持。

此外，如果您希望实现嵌入高级功能，可以继续阅读下一章节。

开始集成

嵌入高级功能