# PlayDrop 能为你的游戏带来什么

PlayDrop 游戏借助 SDK、catalogue.json 和托管能做什么，每项功能在哪里可用，以及各项功能的指南：存档、排行榜、队伍、服务器、收益等。

Source: https://www.playdrop.ai/zh-hans/create/learn/playdrop-games

PlayDrop 游戏是一款由 PlayDrop 托管、列出，并在其网站和适用于 iOS、Android、Windows 和 macOS 的 PlayDrop 应用中运行的网页游戏。在应用中，游戏全屏运行，周围没有浏览器地址栏；它是在应用的游戏视图中运行的同一款网页游戏，而不是单独的原生版本。本页列出 PlayDrop 可以添加的功能，以及每部分的文档所在之处。

## 两种方式

| | 简单 HTML | 包 |
|---|---|---|
| 你发送什么 | 一个独立的 HTML 文件，最大 10 MiB | 一个带 catalogue.json 的已构建文件夹、ZIP 或 .play |
| PlayDrop SDK | 不支持 | 支持，包括下面的所有功能 |
| 商店页面图片和视频 | 不支持 | 支持 |
| 托管游戏服务器 | 不支持 | 支持 |
| 指南 | [简单 HTML 游戏](https://www.playdrop.ai/zh-hans/create/learn/html-games) | [打包](https://www.playdrop.ai/zh-hans/create/learn/packaging) |

任何游戏都可以从简单方式开始，之后以相同的名称和链接变成包。

## 玩家能获得什么

| 功能 | 为玩家带来什么 | 指南 |
|---|---|---|
| 宿主生命周期 | 干净的暂停和恢复，跟随玩家静音设置的音频，快速显示的第一帧 | [加载、暂停和音频](https://www.playdrop.ai/zh-hans/create/learn/lifecycle) |
| 全屏布局 | 铺满屏幕的游玩画面，HUD 避开刘海和 PlayDrop 的控件 | [全屏和安全区域](https://www.playdrop.ai/zh-hans/create/learn/viewport) |
| 云存档 | 在设备之间跟随玩家的进度 | [云存档](https://www.playdrop.ai/zh-hans/create/learn/cloud-saves) |
| 排行榜 | 最高分和玩家的排名 | [排行榜](https://www.playdrop.ai/zh-hans/create/learn/leaderboards) |
| 成就 | 带图标和进度的目标 | [成就](https://www.playdrop.ai/zh-hans/create/learn/achievements) |
| 分享和邀请 | 带图片或短片的分享面板、好友邀请，以及聊天中的游戏卡片 | [分享、好友和邀请](https://www.playdrop.ai/zh-hans/create/learn/social) |
| 在线队伍和语音 | 朋友们一起加入同一个房间，可选房间语音 | [在线队伍和语音](https://www.playdrop.ai/zh-hans/create/learn/online-party) |
| 本地队伍和控制器 | 在同一块屏幕上把手柄和手机当作控制器 | [本地队伍和控制器](https://www.playdrop.ai/zh-hans/create/learn/local-party) |
| 实时服务器 | Colyseus 房间，每款游戏一个 MongoDB 数据库 | [实时游戏服务器](https://www.playdrop.ai/zh-hans/create/learn/game-servers) |
| 评价、打赏、购买和广告 | 让玩家支持游戏的方式；为创作者带来点数 | [变现](https://www.playdrop.ai/zh-hans/create/learn/monetization) |
| 素材和 AI 生成 | 共享素材、生成的媒体和玩家作品 | [游戏素材](https://www.playdrop.ai/zh-hans/create/learn/game-assets)、[AI 素材](https://www.playdrop.ai/zh-hans/create/learn/ai-assets)、[自定义格式](https://www.playdrop.ai/zh-hans/create/learn/custom-assets) |

## 商店页面能获得什么

catalogue.json 为游戏提供它的页面：标题、说明、类型和[标签](https://www.playdrop.ai/zh-hans/create/learn/tags)、[图标、主视觉图、截图和视频](https://www.playdrop.ai/zh-hans/create/learn/listing-assets)、[翻译](https://www.playdrop.ai/zh-hans/create/learn/localization)以及[即玩](https://www.playdrop.ai/zh-hans/create/learn/instant-games)资格。[可见性](https://www.playdrop.ai/zh-hans/create/learn/distribution)决定谁可以打开它：私密用于测试，不公开列出供任何拿到链接的人游玩，公开则可在 PlayDrop 上被发现，并对搜索引擎开放。公开列出会带来被发现的机会，但不保证有玩家。

## 每项功能在哪里可用

网站和应用用同一个 SDK 运行同一款游戏，但有些宿主功能取决于设备：

- 触感反馈只在原生应用中可用；`sdk.haptics.supported` 会告诉你。
- 分享视频短片取决于宿主；不支持的宿主会拒绝，而不是改为分享普通链接。
- 离线游玩和文件预加载在原生应用中进行，适用于声明了它们的游戏；网站会在线加载游戏。
- 房间语音和队伍取决于宿主版本、登录状态和平台的功能推出进度。
- 广告取决于宿主和可用的广告资源；没有准备好的广告时，`load()` 会报告。

请把游戏设计成在缺少某项可选服务时仍然可以玩。

## 从 SDK 开始

加载 SDK，读取宿主状态，然后在设计好的第一帧显示在屏幕上时发出就绪信号：

```html
<script src="https://assets.playdrop.ai/sdk/playdrop.js"></script>
<script type="module">
  const sdk = await playdrop.init();
  // Set up pause, audio and HUD from sdk.host, then render the first frame.
  sdk.host.ready();
</script>
```

接下来请阅读[加载、暂停和音频](https://www.playdrop.ai/zh-hans/create/learn/lifecycle)。[客户端 SDK 参考](https://www.playdrop.ai/zh-hans/create/learn/sdk)列出了所有命名空间。

## 连接器不能做什么

你的 AI 应用可以发布已构建的游戏并读取你的账号。它不能打开或修改在 PlayDrop Studio 中制作的游戏，不能返回源代码，也不能上传可执行的 3D 模型代码。这些限制属于连接器，而不是平台：Studio 和 PlayDrop 自己的工具仍然可以做到。

## 相关指南

- [简单 HTML 游戏](https://www.playdrop.ai/zh-hans/create/learn/html-games): 用 upload_game 发布一个最大 10 MiB 的独立 HTML 文件：适用范围、迷你 catalogue、可见性、更新，以及何时改用包。
- [打包和 .play](https://www.playdrop.ai/zh-hans/create/learn/packaging): 整理一个根目录带有 catalogue.json 的已构建游戏文件夹、ZIP 或 .play，声明商店页面媒体和服务器，并用 prepare_catalogue_upload 上传。
- [加载、暂停和音频](https://www.playdrop.ai/zh-hans/create/learn/lifecycle): 初始化 PlayDrop SDK，在第一个可玩帧时发出就绪信号，干净地暂停和恢复，遵循宿主的音频策略，并为原生应用和离线游玩预加载文件。
- [客户端 SDK](https://www.playdrop.ai/zh-hans/create/learn/sdk): PlayDrop 浏览器 SDK 参考：初始化、宿主生命周期、玩家身份和存档、设备和控制器、社交、多人游戏、商店、广告、排行榜、成就、素材和 AI。