附加指南

本章节包含与now.gg云（now.gg Cloud）相关的附加指南，以帮助您方便地配置我们的服务和API。

可用的附加指南

提供以下指南：

• 用于保存用户状态的云存储设置
• 准备应用程序文件
• 添加和配置自定义域
• 使用now.gg命令行界面（now.gg CLI）上传应用程序
• 理解订阅
• 使用嵌入模块在您的网站上启用云游戏
• now.gg游戏的主机系统和浏览器要求

用于保存用户状态的云存储设置

本部分重点介绍如何设置now.gg云存储，通过定义保存的文件路径和排除的文件路径，以保存和恢复用户的游戏进度数据。

定义“保存”（‘Save’）和“排除”（‘Excluded’）文件路径是一项基本实践，可以减少游戏的加载时间，以增强用户体验并确保now.gg云存储的最优利用。

要设置云存储，您应指定以下内容：

• 要保存的文件路径
  表示应保存在云上的文件或文件夹的位置。通常要保存的文件存储在 /data/data/<package_name>/<file_name>。
• 要排除的文件路径
  表示您不想在云上保存的文件和文件夹的位置。

配置文件路径

您可以为now.gg云发布的任何新应用配置此设置。如果您的应用已经发布，您将需要发布一个新的版本。

配置文件的路径：

• 登录到 nowStudio.
• 您可以：
  • 添加一个新的应用。
    • 按照 此处的说明 添加一个新的应用。
  • 发布一个新的版本。
    • 按照 此处的说明 发布一个新的版本。
• 在应用内容（’App Contents’）标签：
  • 提供要保存的文件路径（Save File Path(s)）和排除的文件路径（Excluded File Path(s)）：
    
  • 点击保存Save。
• 单击左侧导航栏中的发布Release。
  • 为您的应用 创建发布。

注意：

• 如果您有多个文件路径，请用换行符而不是空格或逗号来分隔每个路径。
• 对于保存的文件路径，只有您指定的文件和文件夹才会被保存并恢复到下一个用户会话。
• 对于排除的文件路径（可选），您指定的文件和文件夹将不会保存在云上。

准备应用程序文件

通过本指南，您可以准备要上传到nowStudio的应用程序文件。

要使用nowStudio创建发布，您需要准备应用程序文件。我们接受独立的APK，或者APK和资源（Assets）Zip文件。

{
    "assets": [
        {    
            "name": "asset1.xyz",
            "location": "/data/media/0/Android/data/<packageName>/files"
        },
        {
            "name": "asset2.unity3d",
            "location": "/data/media/0/Android/data/<packageName>/files"
        },
        {
            "name": "OtherAssets",
            "location": "/data/data/<packageName>/files"
        }
    ]
}

添加和配置自定义域

如果您想将应用程序托管在now.gg以外的域上，本指南将详细介绍为应用程序添加自定义域的过程。

另外除了now.gg云，您还可以通过在nowStudio上为您的应用程序添加自定义域来在其他域上托管您的应用程序。

介绍了以下方案：

• 为新应用添加一个自定义域。
• 为已发布的应用添加一个自定义域。

1. 为新应用添加自定义域

本节介绍为新的应用程序添加自定义域的步骤。

请按照以下操作：

• 添加新应用程序后。
• 从所有应用程序（All Apps）部分选择您的应用程序。
  • 点击应用程序名称前的查看详情（View Details）。
• 在产品（Production）中，点击信息（Information）。
• 在给定字段中输入自定义域（custom domain）地址，如下所示：
  
  注意：请确保您拥有要添加的域。
• 请确保您填写了其他必需的详情。
• 点击保存（Save）。
  • 我们的团队将验证您提供的域详情。一旦域详情得到验证，您就可以继续映射您的域。
• 在您提供了所有必要的应用程序信息后，您可以继续为您的应用程序 创建发布版本。
• 收到映射详情后，您可以点击“信息”（Information）标签中的“映射详情”（’Mapping details’）来查看，如下图所示：
  
• 提供了域映射详情，如下图所示：
  
• 您可以使用提供的详情配置DNS提供商。
• 在您对DNS提供商执行所提供的配置后，您的游戏将在您的域上可用。

2. 为已发布的应用程序添加自定义域

本节介绍为已发布应用程序添加自定义域的步骤。

请执行此下操作：

• 从所有应用程序（All Apps）中选择您的应用程序。
  • 点击应用程序名称前的查看详情（View Details）。
• 在左侧边栏的产品（Production）中点击信息（Information）。
• 点击右下角的编辑（Edit）按钮。
  （这将使您能够编辑所提供的字段）
• 在给定字段中输入自定义域地址，如下所示：
  
  注意：请确保您拥有要添加的域。
• 点击保存（Save）。
• 一条确认信息将显示在屏幕上，如下图所示：
  
• 我们的团队将验证您提供的域详情。一旦域详情得到验证，您就可以继续映射您的域。
• 收到映射详情后，您可以点击“信息”（’Information’）标签中的“映射详情”（’Mapping details’）来查看，如下所示：
  
• 提供了域映射详情，如下图所示：
  
• 您可以使用提供的详情配置DNS提供商。
• 在您对DNS提供商执行所提供的配置后，您的游戏将在您的域上可用。

使用Nowgg命令行界面（nowgg CLI）上传应用程序

nowgg CLI是一种命令行工具，可让您轻松地将应用构建上传到nowStudio。本指南将详细介绍这一功能。

使用 nowgg CLI

在macOS或者Windows打开任意终端（terminal）。

安装和初始化

  pip install nowgg

  nowgg init --token "<your_publisherToken_from_nowStudio>"

使用nowgg CLI将应用程序上传到nowStudio

  nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <app_version_name> --version_code <app_version_code>

  nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <apk_version> --version_code <app_version_code> --deploy 

帮助

  nowgg -h
   nowgg init -h
   nowgg upload -h

理解订阅（Subscriptions）

以下文档重点介绍了nowStudio提供的订阅功能的重要方面。

订阅是now.gg上的应用内产品，向用户收取访问您应用内内容或服务的定期费用。

nowStudio提供多功能的“订阅”功能，使您能够轻松创建、管理和销售订阅。应用内产品和订阅产品的主要区别在于，应用内产品向用户收取的是一次性费用，而订阅涉及的是定期性费用。

要理解如何在nowStudio中创建和管理订阅：

• 参考 – 创建和管理订阅章节。

要理解如何使用now.gg支付模块在应用程序中实现订阅，请参考以下指南：

• Unity
• 原生Android

重要：除本页信息外，您还应参考 now.gg政策。

订阅概述

本节介绍订阅。

• 订阅
• 计费周期
  • 自动续订
• 权益（Benefits）
• 订价
  • 价格变动

订阅

订阅提供了一组用户可以在指定时间段内访问的权益。您可以在同一应用程序中拥有多个订阅，以代表不同的权益集或单个权益集的不同等级，例如“黄金”和“钻石”套餐。用户通过在now.gg上的应用购买订阅，从而获得订阅的访问权限。

计费周期

now.gg可以让您选择订阅的持续时间。可用的计费周期为：

• 每4周
• 每月
• 每2个月
• 每3个月
• 每4个月
• 每6个月
• 每8个月
• 每年

权益（Benefits）

您最多可以向订阅添加四项权益，帮助用户理解他们将收到哪些权益。您应该突出显示与您的订阅相关的核心权益。

被拒绝的支付

如果续订支付被拒绝，now.gg将提示用户解决支付问题。如果未解决，订阅将自动过期。

使用嵌入模块在您的网站上启用云游戏

now.gg嵌入（Embed）Javascript 模块为开发者提供了框架，使他们能够在网站上无缝嵌入云游戏。

通过now.gg嵌入模块，开发者能：

• 在任何网页上轻松嵌入游戏。
• 实现嵌入的高级功能，应用和嵌入了其游戏的网页能进行事件驱动（event-driven）的通信。
• 通过在其网站上嵌入游戏，让游戏获得更好的曝光度，从而提高用户参与度和留存率。

前提条件

在集成now.gg嵌入模块之前，必须满足以下前提条件：

• 将域名加入白名单 – now.gg嵌入将只在被我们列为白名单的域名里工作。请通过 dev-support@now.gg 联系我们，提供您希望加入的白名单的域名列表。
• clientId – 请通过 dev-support@now.gg 联系我们，获取您的 clientId。
• appId – 请按照 此处说明的步骤，获取您的appId。

实施嵌入模块

要集成now.gg嵌入模块：

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

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

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

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

// 用于处理javascript 模块事件的回调函数。
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,
    isNowLoginEnabled: true
});

嵌入高级功能

本节说明了如何在您网站（HTML页面）上的嵌入游戏实现高级功能。

为进一步提升游戏体验，now.gg嵌入模块使您能够：

• 从您now.gg云上的应用程序传递事件和数据到您的HTML页面。
• 在应用程序启动时传递启动参数到您的应用程序。

前提条件

• 请先下载并将 now.gg事件模块 集成到您的Android应用中，以启用以下功能。

1. 从应用程序传递事件到HTML页面

在您集成了now.gg事件模块后，您可以将事件和数据从您在now.gg云上的应用程序传递到嵌入游戏的HTML页面。

请参考 :

• now.gg事件模块文档的 发送事件和数据到HTML页面 章节。
  • Unity
  • Native Android

2. 在您应用启动时从HTML页面传递参数到应用程序

现在，您可以从HTML页面向您的应用程序传递应用启动参数。我们提供了示例代码片段，用于定义传递给 NowIfp.init 的 appLaunchData，并在您的应用获取它。

NowIfp.init({
     clientId: <"your_clientId"> ,
     appId: <"your_appId"> ,
     iframeParentElement: iframeParentElement,
     customData: {} // 用于应用特定的自定义处理
     appLaunchData: {
           [key]: [value]
     } 
      // 启动时传递启动参数给Iframe，它将被序列化并在launch intent传递给应用。
     appEventCallback: appEventCallbackFunction,
     sdkEventCallback: sdkEventCallbackFunction,
     isNowLoginEnabled: true
 });

//使用key获取作为应用启动参数的value
 string value = NowGGEventsSdkManager.Instance.GetAppLaunchDataProperty(key);

演示工程

本节展示了now.gg嵌入模块的演示HTML页面，并解释了与嵌入模块关联的端到端流程。

请按照以下步骤浏览嵌入模块的演示：

• 点击这里启动 now.gg嵌入模块演示
  
• 该嵌入演示展示了：
• 应用程序启动数据
  • 如果您希望在launch intent添加任何 appLaunchData：
  • 点击+按钮。
    
  • 您可以通过Key和Value字段提供输入。
• 模块 Init
  • 点击初始化嵌入模块（Initialize 嵌入模块）按钮来初始化模块并启动云游戏。
  • 初始化事件由 sdkEventCallback捕获，如下图所示。
    
  • 初始化成功后，嵌入游戏开始运行，如下图所示：
  • 
• 从Unity发送数据到HTML（web客户端）
  • 打开链接（Open Link）
    • 打开链接按钮将在新标签页中打开提供的链接。
  • 浏览器事件（Browser Event）
    • 浏览器事件按钮将数据从Unity发送到HTML页面，您可以根据您的实现进行处理。
    • 应用程序事件由 appEventCallback 函数捕获，如下图所示：