# PlayDrop 為你的遊戲加入的功能

PlayDrop 遊戲透過 SDK、catalogue.json 和託管能做到什麼、各項功能在哪裡適用，以及各自的指南：存檔、排行榜、派對、伺服器、收益等。

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

PlayDrop 遊戲是由 PlayDrop 託管、上架，並在網站以及 iOS、Android、Windows 和 macOS 版 PlayDrop App 中執行的網頁遊戲。在 App 中，遊戲會全螢幕遊玩，周圍沒有瀏覽器列；它是在 App 的遊戲畫面中執行的同一款網頁遊戲，而不是另外的原生建置版本。本頁列出 PlayDrop 能加入的功能，以及各部分的說明文件在哪裡。

## 兩種方式

| | 簡易 HTML | 套件 |
|---|---|---|
| 你傳送的內容 | 一個獨立的 HTML 檔案，最多 10 MiB | 附 catalogue.json 的建置資料夾、ZIP 或 .play |
| PlayDrop SDK | 否 | 是，包含下列所有功能 |
| 上架圖片與影片 | 否 | 是 |
| 託管遊戲伺服器 | 否 | 是 |
| 指南 | [簡易 HTML 遊戲](https://www.playdrop.ai/zh-hant/create/learn/html-games) | [打包](https://www.playdrop.ai/zh-hant/create/learn/packaging) |

任何遊戲都可以從簡易方式開始，之後再以相同的名稱和連結變成套件。

## 玩家能獲得什麼

| 功能 | 帶給玩家什麼 | 指南 |
|---|---|---|
| 主機端生命週期 | 順暢的暫停與恢復、跟隨玩家靜音設定的音訊、快速出現的第一幀 | [載入、暫停與音訊](https://www.playdrop.ai/zh-hant/create/learn/lifecycle) |
| 全螢幕版面 | 滿版遊玩，HUD 避開瀏海與 PlayDrop 的控制項 | [全螢幕與安全區域](https://www.playdrop.ai/zh-hant/create/learn/viewport) |
| 雲端存檔 | 在不同裝置之間跟著玩家的進度 | [雲端存檔](https://www.playdrop.ai/zh-hant/create/learn/cloud-saves) |
| 排行榜 | 最高分數與玩家的排名 | [排行榜](https://www.playdrop.ai/zh-hant/create/learn/leaderboards) |
| 成就 | 附圖示與進度的目標 | [成就](https://www.playdrop.ai/zh-hant/create/learn/achievements) |
| 分享與邀請 | 附圖片或短片的分享面板、好友邀請，以及聊天中的遊戲卡片 | [分享、好友與邀請](https://www.playdrop.ai/zh-hant/create/learn/social) |
| 線上派對與語音 | 朋友一起加入同一個房間，並可選擇使用房間語音 | [線上派對與語音](https://www.playdrop.ai/zh-hant/create/learn/online-party) |
| 本機派對與控制器 | 在同一個螢幕上把手把和手機當作控制器 | [本機派對與控制器](https://www.playdrop.ai/zh-hant/create/learn/local-party) |
| 即時伺服器 | 每款遊戲各有一個 MongoDB 資料庫的 Colyseus 房間 | [即時遊戲伺服器](https://www.playdrop.ai/zh-hant/create/learn/game-servers) |
| 評論、打賞、購買與廣告 | 讓玩家支持遊戲的方式；創作者可獲得點數 | [營利](https://www.playdrop.ai/zh-hant/create/learn/monetization) |
| 素材與 AI 生成 | 共用素材、生成的媒體和玩家創作 | [遊戲素材](https://www.playdrop.ai/zh-hant/create/learn/game-assets)、[AI 素材](https://www.playdrop.ai/zh-hant/create/learn/ai-assets)、[自訂格式](https://www.playdrop.ai/zh-hant/create/learn/custom-assets) |

## 上架資訊能獲得什麼

catalogue.json 為遊戲提供它的頁面：標題、說明、類型與[標籤](https://www.playdrop.ai/zh-hant/create/learn/tags)、[圖示、主視覺、截圖與影片](https://www.playdrop.ai/zh-hant/create/learn/listing-assets)、[翻譯](https://www.playdrop.ai/zh-hant/create/learn/localization)，以及[即玩](https://www.playdrop.ai/zh-hant/create/learn/instant-games)資格。[可見性](https://www.playdrop.ai/zh-hant/create/learn/distribution)決定誰能開啟它：私人用於測試，不公開讓任何有連結的人遊玩，公開則能在 PlayDrop 上被發現，並對搜尋引擎開放。公開上架能創造被發現的機會；但不保證有玩家。

## 各項功能在哪裡適用

網站和 App 以相同的 SDK 執行相同的遊戲，但有些主機端功能取決於裝置：

- 觸覺回饋只在原生 App 中有效；`sdk.haptics.supported` 會告訴你。
- 分享影片短片取決於主機端；不支援的主機端會拒絕，而不是改為分享一般連結。
- 離線遊玩與檔案預先載入，只會在原生 App 中針對有宣告的遊戲進行；網站則在線上載入遊戲。
- 房間語音和派對取決於主機端的建置版本、登入狀態和平台的開放進度。
- 廣告取決於主機端和可用的廣告庫存；沒有廣告準備好時，`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-hant/create/learn/lifecycle)。[用戶端 SDK 參考](https://www.playdrop.ai/zh-hant/create/learn/sdk)列出了每個命名空間。

## 連接器不能做的事

你的 AI App 會發布建置好的遊戲並讀取你的帳號。它無法開啟或變更在 PlayDrop Studio 中製作的遊戲、傳回原始碼，或上傳可執行的 3D 模型程式碼。這些是連接器的限制，不是平台的限制：Studio 和 PlayDrop 自己的工具仍然可以做到。

## 相關指南

- [簡易 HTML 遊戲](https://www.playdrop.ai/zh-hant/create/learn/html-games): 用 upload_game 發布一個最多 10 MiB 的獨立 HTML 檔案：適用範圍、迷你目錄、可見性、更新，以及何時改用套件。
- [打包與 .play](https://www.playdrop.ai/zh-hant/create/learn/packaging): 安排根目錄含 catalogue.json 的建置遊戲資料夾、ZIP 或 .play，宣告上架媒體與伺服器，並用 prepare_catalogue_upload 上傳。
- [載入、暫停與音訊](https://www.playdrop.ai/zh-hant/create/learn/lifecycle): 初始化 PlayDrop SDK，在第一個可遊玩的畫面發出就緒訊號，順暢地暫停與恢復，遵循主機端的音訊政策，並為原生 App 與離線遊玩預先載入檔案。
- [用戶端 SDK](https://www.playdrop.ai/zh-hant/create/learn/sdk): PlayDrop 瀏覽器 SDK 參考：初始化、主機端生命週期、玩家身分與存檔、裝置與控制器、社群、多人連線、商店、廣告、排行榜、成就、素材與 AI。