API 规范

Ingress

HTTP API

Unreal 渲染器微服务公开了一个 HTTP API。通过此 API，您可以

• 向微服务添加和移除活动流。

您可以在 HTTP API 文档中找到更多信息。

流管理

Unreal 渲染器微服务是一个有状态的服务，仅在注册具有流 ID 的流后才开始流式传输。

可以使用以下方式添加动画数据流

stream_id=$(uuidgen)
curl -X POST -s http://127.0.0.1:8021/streams/$stream_id

同样，可以使用以下方式移除动画数据流

curl -X DELETE -s http://127.0.0.1:8021/streams/$stream_id

请注意，Unreal 渲染器微服务仅支持单个流。

Egress

gRPC API

Unreal 渲染器微服务连接到动画数据合成器（例如，动画图微服务）以接收动画数据流。此动画数据流通过 PullAnimationDataStream 远程过程调用 (RPC) 请求。然后，渲染器更新头像姿势，渲染图像，并通过 WebRTC 将图像流式传输到下游组件。RPC 在动画数据服务中定义。

传播 API

如果控制器无法完成，Unreal 渲染器微服务可以将添加和移除流 HTTP API 调用传播到下游组件。

您可以在传播 HTTP API 文档中找到更多信息。