Developer Preview 0.3.0.dev2：本页介绍未改变的 SDK 0.2.0 基础契约。统一适配器、可选模拟运动及当前安装命令请参阅快速开始和软件包内文档。未启用真实硬件或生产集成。
版本、错误及能力矩阵
以下均为合成操作，不是硬件支持列表。每项需要主机精确授权；采集/录制还需明确同意。机器可读版本见 templates/matrices.json。中文技术人工审核待完成。
SDK 0.2.0 / wire contract 1.0. Accept 1.0; reject 1.1/2.0. No implicit downgrade/fallback.
| Capability.operation | Request fields | Response fields | Capture consent | Physical |
|---|---|---|---|---|
| MicrophoneAudioInput.sample | sample_rate, frames | audio_base64, sample_rate, channels, codec | True | BLOCKED_EXTERNAL |
| SpeakerAudioOutput.play | audio_base64, sample_rate, channels, codec | accepted | False | BLOCKED_EXTERNAL |
| Camera.snapshot | width, height, format | width, height, format, pixels_base64 | True | BLOCKED_EXTERNAL |
| Display.present | text | accepted | False | BLOCKED_EXTERNAL |
| UserControls.poll | {} | control | False | BLOCKED_EXTERNAL |
| Sensors.read | sensor_type | sensor_type, values | True | BLOCKED_EXTERNAL |
| Recording.start | retention_seconds | recording, retained_bytes | True | BLOCKED_EXTERNAL |
| Recording.stop | {} | recording, retained_bytes | True | BLOCKED_EXTERNAL |
| Recording.status | {} | recording, retained_bytes | True | BLOCKED_EXTERNAL |
| BasicDeviceStatus.read | {} | connected, battery_percent | False | BLOCKED_EXTERNAL |
| ConnectivityEvents.poll | {} | state | False | BLOCKED_EXTERNAL |
Error enums
- unsupported: Declared operation cannot be performed; no fallback.
- unavailable: Resource unavailable; actual completion may be uncertain.
- cancelled: Cancellation reported; host still distinguishes confirmed stop.
- timeout: Deadline exceeded; no automatic replay.
- invalid_request: Bounded request rejected.
- none: Success only.
Host lifecycle outcomes
queued → dispatched → completed/failed/unknown. Cancellation before dispatch is cancelled; after dispatch remote stop is unconfirmed. Expired before dispatch never executes. Reconnect uses fresh epoch; no automatic replay.
Platform evidence
Linux: offline source/protocol tests only. Windows/macOS: NOT_RUN for this kit release. iOS/Android/native toolchains and real hardware: BLOCKED_EXTERNAL.
错误说明：unsupported=不支持，unavailable=资源不可用，cancelled=取消报告但远端停止可能未确证，timeout=超时且禁止自动重放，invalid_request=请求被拒绝，none=仅成功。生命周期 queued/dispatched/completed/failed/unknown 为原始技术标识；派发前过期不执行，派发后取消不意味着已停止；重连须新 epoch。所有平台状态仅说明本版证据。