從這裡開始
PlayDrop 為你的遊戲加入的功能
PlayDrop 遊戲透過 SDK、catalogue.json 和託管能做到什麼、各項功能在哪裡適用，以及各自的指南：存檔、排行榜、派對、伺服器、收益等。
PlayDrop 遊戲是由 PlayDrop 託管、上架，並在網站以及 iOS、Android、Windows 和 macOS 版 PlayDrop App 中執行的網頁遊戲。在 App 中，遊戲會全螢幕遊玩，周圍沒有瀏覽器列；它是在 App 的遊戲畫面中執行的同一款網頁遊戲，而不是另外的原生建置版本。本頁列出 PlayDrop 能加入的功能，以及各部分的說明文件在哪裡。
兩種方式
| 簡易 HTML | 套件 | |
|---|---|---|
| 你傳送的內容 | 一個獨立的 HTML 檔案，最多 10 MiB | 附 catalogue.json 的建置資料夾、ZIP 或 .play |
| PlayDrop SDK | 否 | 是，包含下列所有功能 |
| 上架圖片與影片 | 否 | 是 |
| 託管遊戲伺服器 | 否 | 是 |
| 指南 | 簡易 HTML 遊戲 | 打包 |
任何遊戲都可以從簡易方式開始，之後再以相同的名稱和連結變成套件。
玩家能獲得什麼
| 功能 | 帶給玩家什麼 | 指南 |
|---|---|---|
| 主機端生命週期 | 順暢的暫停與恢復、跟隨玩家靜音設定的音訊、快速出現的第一幀 | 載入、暫停與音訊 |
| 全螢幕版面 | 滿版遊玩，HUD 避開瀏海與 PlayDrop 的控制項 | 全螢幕與安全區域 |
| 雲端存檔 | 在不同裝置之間跟著玩家的進度 | 雲端存檔 |
| 排行榜 | 最高分數與玩家的排名 | 排行榜 |
| 成就 | 附圖示與進度的目標 | 成就 |
| 分享與邀請 | 附圖片或短片的分享面板、好友邀請，以及聊天中的遊戲卡片 | 分享、好友與邀請 |
| 線上派對與語音 | 朋友一起加入同一個房間，並可選擇使用房間語音 | 線上派對與語音 |
| 本機派對與控制器 | 在同一個螢幕上把手把和手機當作控制器 | 本機派對與控制器 |
| 即時伺服器 | 每款遊戲各有一個 MongoDB 資料庫的 Colyseus 房間 | 即時遊戲伺服器 |
| 評論、打賞、購買與廣告 | 讓玩家支持遊戲的方式；創作者可獲得點數 | 營利 |
| 素材與 AI 生成 | 共用素材、生成的媒體和玩家創作 | 遊戲素材、AI 素材、自訂格式 |
上架資訊能獲得什麼
catalogue.json 為遊戲提供它的頁面：標題、說明、類型與標籤、圖示、主視覺、截圖與影片、翻譯，以及即玩資格。可見性決定誰能開啟它：私人用於測試，不公開讓任何有連結的人遊玩，公開則能在 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>接著閱讀載入、暫停與音訊。用戶端 SDK 參考列出了每個命名空間。
連接器不能做的事
你的 AI App 會發布建置好的遊戲並讀取你的帳號。它無法開啟或變更在 PlayDrop Studio 中製作的遊戲、傳回原始碼，或上傳可執行的 3D 模型程式碼。這些是連接器的限制，不是平台的限制：Studio 和 PlayDrop 自己的工具仍然可以做到。