附加指南

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

可用的附加指南

提供以下指南：

• 用于保存用户状态的云存储设置
• 准备应用程序文件
• 添加和配置自定义域
• 使用now.gg命令行界面（now.gg CLI）上传应用程序
• 理解订阅

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

本部分重点介绍如何设置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将提示用户解决支付问题。如果未解决，订阅将自动过期。