兼容性
第一个 public compatibility line 是 0.1.x。
| Package line | Documented version | Protocol | Capability | Runtime |
|---|---|---|---|---|
@consenger/[email protected] | 0.1.0-alpha.0 | companion.plugin.v1 | companion.plugin.v1 | Vifu Web iframe, iOS WKWebView |
版本策略
patch release 会保持相同 protocol 和 capability。它可以加入 documentation、diagnostics、browser bundle fix 和 non-breaking helper。
minor release 可以加入 API 或 capability。游戏在需要新 capability 前，可以继续停留在 0.1.x。
protocol-breaking change 需要新的 compatibility line 和 capability name。声明 companion.plugin.v1 的游戏应继续获得 v1 host bridge behavior。
Host 要求
- Vifu Web 使用
window.postMessage。 - iOS WKWebView runtime 使用
window.webkit.messageHandlers.consengerHost。 - 不依赖 server-side code 的 static game entry。
- context、command input、command result、observation payload 都需要 JSON-serializable。