应用在 app.json 的 services 中声明平台分配的 { id, contractVersion }。向平台确认允许的方法、路径、响应结构、身份要求及联网路由。Host 配置服务来源和认证，H5 传入 serviceId 与约定路径。
读取与写入
| 任务 | 入口 | 应用权限 |
|---|---|---|
| 读取 JSON | glass.http.request({ serviceId, path, method: 'GET' }).result |
network.http |
| 写入业务数据 | glass.operations.enqueue({ type: 'service.write', idempotencyKey, serviceId, path, method, body }) |
network.http、operations.durable |
| 下载文件 | glass.files.download({ serviceId, path }).result |
network.http、files.transfer |
| 上传文件 | glass.files.upload({ fileId, serviceId, path, idempotencyKey }) |
network.http、files.transfer、operations.durable |
普通 HTTP 入口使用 GET。写入支持 POST、PUT、PATCH、DELETE，先保存固定请求与幂等键，再按 持久操作 执行。HTTP 非 2xx 也可作为响应返回，使用 status 和服务契约判断结果。
import { glass } from '@glass/bridge';
export async function readJson(serviceId: string, path: string) {
await glass.ready();
const response = await glass.http.request({ serviceId, path, method: 'GET' }).result;
if (response.status < 200 || response.status >= 300) {
throw new Error(`服务读取失败，HTTP ${response.status}`);
}
return response.body;
}传输状态与连接
文件字节由 Host 传输。下载成功返回 fileId、大小、摘要及 MIME 等元数据。上传成功返回服务契约中的 remoteId。上传使用受管文件，后端上传方式由对接契约决定。Task 或持久操作的进度应来自实际字节；总量未知时仅显示已完成字节。最终结果从 Task Promise 或操作快照取得。
普通服务可按环境使用眼镜直连或手机中继。手机已连接、已启用中继和服务可达是三个独立状态。读取失败时可先检查 glass.system.getConnection() 和 glass.network.getStatus()，等连接恢复后重新读取。原写入或上传的结果未知时，查询原操作。使用平台业务账号的服务另有会话和权限要求，接入方式由平台确认。