# PlayDrop 的即玩遊戲與一般遊戲

PlayDrop 遊戲成為即玩遊戲的條件：直向遊玩、訪客可玩、啟動檔案最多 10 MiB、兩秒內開始，以及它與一般遊戲的差異。

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

即玩遊戲是 PlayDrop 手機 App 即玩動態中的直向短遊戲：玩家一滑，下一款遊戲就已經開始了。其他所有遊戲都是一般遊戲，從遊戲頁面、搜尋或連結開啟。兩者的發布方式相同；即玩是版本的屬性。

## 即玩或一般

| | 即玩 | 一般 |
|---|---|---|
| 遊玩位置 | 即玩動態，以及所有一般遊戲能玩的地方 | 首頁、搜尋、遊戲頁面、連結 |
| 方向 | 以直向為主 | 任何已宣告的顯示環境 |
| 登入 | 訪客可玩 | 任何 `authMode` |
| 開始 | 2 秒內可遊玩 | 沒有限制，但越快越好 |
| 啟動檔案 | 最多 10 MiB | 沒有啟動限制 |
| 徽章 | 閃電徽章 | 無 |

未達即玩標準的遊戲，仍會以一般遊戲發布。

## 需求

```json
{
  "primarySurface": "MOBILE_PORTRAIT",
  "surfaceTargets": { "desktop": true, "mobileLandscape": false, "mobilePortrait": true },
  "authMode": "OPTIONAL",
  "instant": true,
  "prefetch": { "required": ["game.js", "atlas.png"], "optional": ["music.mp3", "levels/world-2.json"] }
}
```

- `primarySurface` 為 `MOBILE_PORTRAIT`，且遊戲支援直向手機。
- `authMode` 為 `OPTIONAL` 或 `NONE`，讓訪客可以玩。
- 啟動檔案最多 10 MiB：入口頁面加上 `prefetch.required`，若未列出則為所有上傳的檔案。
- `instant: true` 宣告即玩資格。

上傳時會檢查大小，回執中的 `instant` 和 `instantReason` 會回報結果。發布後，PlayDrop 會在 App 中測量實際啟動：一旦某個版本累積 20 次以已下載檔案啟動的紀錄，且其中超過四分之一花了 2 秒以上，就會失去徽章。新版本可以重新取得資格。

## 快速開始

- 將後續關卡、音樂和額外內容放入 `prefetch.optional`，並在 `ready()` 之後載入。
- 在呼叫 `ready()` 前編譯著色器並完成暖機，讓最初幾幀不會卡頓。
- 立即顯示遊戲畫面：第一個動作之前不要有標題畫面、選單或強制登入畫面。
- 讓最初幾秒不靠文字就能讓人看懂。
- 為上架資訊錄製直向遊戲影片；動態會使用它。

預先載入請參閱[載入、暫停與音訊](https://www.playdrop.ai/zh-hant/create/learn/lifecycle)，直向版面請參閱[全螢幕與安全區域](https://www.playdrop.ai/zh-hant/create/learn/viewport)。

## 相關指南

- [載入、暫停與音訊](https://www.playdrop.ai/zh-hant/create/learn/lifecycle): 初始化 PlayDrop SDK，在第一個可遊玩的畫面發出就緒訊號，順暢地暫停與恢復，遵循主機端的音訊政策，並為原生 App 與離線遊玩預先載入檔案。
- [全螢幕與安全區域](https://www.playdrop.ai/zh-hant/create/learn/viewport): 讓 PlayDrop 遊戲填滿螢幕，並用 SDK 實際測量的 reservedCorners，讓 HUD 保持在 CSS 安全區域內、避開主機端的控制項。
- [上架圖片與影片](https://www.playdrop.ai/zh-hant/create/learn/listing-assets): PlayDrop 遊戲可以有哪些上架圖片與影片、它們的路徑、格式與方向，以及如何製作在動態、搜尋和連結預覽中都好看的圖片。
- [catalogue.json](https://www.playdrop.ai/zh-hant/create/learn/catalogue-json): PlayDrop 遊戲使用的 catalogue.json 欄位：身分、上架資訊、遊玩方式、顯示環境、登入、即玩、預先載入、媒體、翻譯、分數與伺服器。