本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用直播 URL 共享直播会话

直播网址可让您快速与任何人共享直播会话。收件人在支持的 Web 浏览器中访问您的直播会话，无需集成 AWS 账户 或客户端，并且您可以控制到期、使用和撤销。创建直播网址后，任何访问该网址的人都无需任何凭证即可启动自己的直播会话。直播网址非常适合快速轻松地设置演示、游戏测试、利益相关者评论和访客访问权限。

直播网址的工作原理

直播网址将直播组（运行直播的容量）和该直播组中的一个应用程序（要运行的内容）联系在一起。当您创建直播网址时，Amazon GameLift Streams 会返回以下格式的直播 URL：

https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN

该工作流程有四个步骤：

由于直播网址未经身份验证，因此最终用户永远不会看到或需要您的 AWS 证书。该服务根据您在创建时设置的直播位置偏好将每个最终用户路由到附近的位置。Amazon GameLift Streams 会按距离对您的首选直播位置进行重新排序，但不会添加您未包括的地点。

终端用户体验

与您共享直播网址的用户无需安装 AWS 账户 任何软件。他们在支持的网络浏览器中打开网址，然后从 Amazon Streams 为您托管的网页进行 GameLift 流式传输。直播使用 WebRTC，其浏览器和设备要求与 Amazon GameLift Streams Web SDK 客户端相同。有关支持的浏览器和最低版本，请参阅兼容 Amazon GameLift Streams 的设备和浏览器。如果最终用户打开 URL 时直播组没有可用容量，则该页面会显示一条消息，提示该直播暂时已满负荷，最终用户可以重试。如果最终用户尝试关闭或重新加载选项卡，则该页面会提示他们进行确认，因为离开该页面会结束会话。

先决条件

在创建直播网址之前，需要满足以下条件：

创建直播网址

以下 AWS CLI 示例为直播组中的应用程序创建了直播 URL。直播网址的有效期为两小时，最多可使用五次，它更喜欢us-west-2和us-east-1位置。

aws gameliftstreams create-stream-url \
    --identifier sg-1AB2C3De4 \
    --application-identifier a-9ZY8X7Wv6 \
    --protocol WebRTC \
    --url-expires-after-minutes 120 \
    --usage-limit 5 \
    --locations us-west-2 us-east-1 \
    --description "Preview build - reviewer invites"

成功调用将返回直播网址资源，包括其StreamUrlId（前缀su-）、其 ARN、完全可共享StreamUrl资源、计算出的到期时间和初始剩余用量。

{
    "StreamUrlId": "su-1AB2C3De4",
    "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamurl/sg-1AB2C3De4/su-1AB2C3De4",
    "StreamUrl": "https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN",
    "Status": "ACTIVE",
    "UsageLimit": 5,
    "RemainingUses": 5,
    "ExpiresAt": "2026-07-31T20:00:00+00:00"
}

以下参数为必需参数：

以下参数为可选参数。您提供的任何会话设置都会在创建时冻结到直播 URL 中，并应用于从该直播 URL 启动的每个会话。

监控您的直播网址

GetStreamUrl用于检索单个直播网址。使用指定直播群组--identifier和直播网址--stream-url-identifier（直播网址 ID 或 ARN）。除了直播网址的配置、当前和RemainingUses以外Status，响应还包括从该网址启动的会话StreamSessions列表，因此您可以查看谁在进行流式传输。

aws gameliftstreams get-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4

ListStreamUrls用于枚举您账户中的直播网址。您可以按直播群组进行Status筛选，并使用MaxResults（1—100，默认为 25）和NextToken对结果进行分页。

aws gameliftstreams list-stream-urls \
    --status ACTIVE \
    --stream-group-identifier sg-1AB2C3De4

您还可以在中审核直播网址管理活动 CloudTrail。 CloudTrail 将对CreateStreamUrlGetStreamUrlListStreamUrls、和的调用记录RevokeStreamUrl为数据事件。最终用户打开直播网址并启动会话不是您的 API 调用之一，也不会被记录为客户 CloudTrail 活动。有关更多信息，请参阅 使用记录 Amazon GameLift Streams API 调用 AWS CloudTrail。

撤销直播网址

当你想阻止某个直播开始任何会话时，例如当预览期结束或可能被无意中共享时，可以撤消该直播网址。

RevokeStreamUrl需要RevocationMode：

aws gameliftstreams revoke-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4 \
    --revocation-mode REVOKE_AND_TERMINATE_SESSIONS

已撤销的直播网址将转换为该REVOKED状态，无法重新激活。如果您需要恢复共享，请创建新的直播网址。

当 GameLift 直播所依赖的资源被删除时，Amazon Streams 还会自动撤销该直播网址。删除直播组将撤消该直播组上的所有直播网址，删除该应用程序将撤消引用该应用程序的所有直播网址。在这两种情况下，直播 URL 都会移至REVOKED，其状态原因可标识已删除的资源。

直播网址生命周期和状态

直播网址是在创建ACTIVE时保持这种状态，直到过期、用完或被撤销。离开该状态ACTIVE后，它永远不会恢复到原来的状态。

当直播网址为REVOKED，GetStreamUrl并且ListStreamUrls还会返回一个解释原因的状态原因。

与您一开始使用的会话的区别 StartStreamSession

会话从与您自己启动的会话相同的基础设施上运行的直播网址开始，但它们经过调整以实现简短、无需动手的单人观看。请记住以下区别：

问题排查

Amazon GameLift Streams 故意向最终用户隐瞒直播网址激活失败的具体原因。无论根本原因如何，打开无法启动直播的直播网址的最终用户始终会看到通用的 “未找到” 页面或 “已满负荷” 消息。要诊断真正的原因，请使用GetStreamUrl和检查创作者端的直播网址ListStreamUrls，检查Status和状态原因，并在中查看直播网址 API 活动 CloudTrail。