aws-sdk-ivsrealtime

亚马逊互动视频服务（IVS）实时 API 与 REST 兼容，使用标准 HTTP API 和 AWS EventBridge 事件流进行响应。请求和响应（包括错误）都使用 JSON 格式。

关键概念

• 阶段 — 参与者可以实时交换视频的虚拟空间。
• 参与者令牌 — 参与者加入阶段时进行身份验证的令牌。
• 参与者对象 — 表示阶段中的参与者（人）并包含有关他们的信息。当创建令牌时，它包含一个参与者 ID；当参与者使用该令牌加入阶段时，参与者与该参与者 ID 相关联。参与者令牌与参与者之间是一对一的映射关系。

对于服务器端合成

• 合成过程 — 将阶段中的参与者合成为一个视频，并将其转发到一组输出（例如 IVS 频道）。合成端点支持此过程。
• 合成 — 控制输出外观，包括参与者如何在视频中定位。

有关您的 IVS 直播流更多信息，请参阅 使用 Amazon IVS 实时流入门。

标记

标签是您为AWS资源分配的元数据标签。标签包括一个键和一个值，均由您设置。例如，您可以设置一个标签为topic:nature来标记特定的视频类别。有关更多信息，包括应用于标签的限制和“标签命名限制和要求”，请参阅AWS资源标签；Amazon IVS阶段没有超出文档所列的服务特定约束。

标签可以帮助您识别和组织您的AWS资源。例如，您可以使用相同的标签为不同的资源标记它们是相关的。您还可以使用标签来管理访问（请参阅访问标签）。

Amazon IVS实时API具有以下与标签相关的端点：TagResource、UntagResource和ListTagsForResource。以下资源支持标签：阶段。

资源最多可应用50个标签。

入门指南

许多服务和操作都有示例，请查看GitHub上的示例文件夹。

SDK为每个AWS服务提供一个新的crate。您必须在Rust项目中将Tokio作为依赖项添加，以执行异步代码。要将aws-sdk-ivsrealtime添加到您的项目中，请在您的Cargo.toml文件中添加以下内容

[dependencies]
aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }
aws-sdk-ivsrealtime = "1.41.0"
tokio = { version = "1", features = ["full"] }

然后在代码中，可以使用以下方式创建客户端

use aws_sdk_ivsrealtime as ivsrealtime;

#[::tokio::main]
async fn main() -> Result<(), ivsrealtime::Error> {
    let config = aws_config::load_from_env().await;
    let client = aws_sdk_ivsrealtime::Client::new(&config);

    // ... make some calls with the client

    Ok(())
}

有关可以进行的调用、以及每个调用的输入和输出的信息，请参阅客户端文档。

使用SDK

在SDK发布之前，我们将向开发者指南添加有关使用SDK的信息。请随时通过提交问题并描述您想尝试的内容来建议指南的附加部分。

获取帮助

• GitHub讨论 - 用于想法、RFC和一般问题
• GitHub问题 - 用于错误报告和功能请求
• 生成文档（最新版本）
• 使用示例

许可证

本项目采用Apache-2.0许可证。