本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

與串流 URLs 共用串流工作階段

串流 URLs 可讓您快速與任何人共用串流工作階段。收件人在支援的 Web 瀏覽器中存取串流工作階段，不需要 AWS 帳戶 或 用戶端整合，而且您可以控制過期、用量和撤銷。建立串流 URL 之後，任何存取此 URL 的人都會啟動自己的串流工作階段，而不需要任何登入資料。串流 URLs非常適合快速輕鬆地設定示範、播放測試、利益相關者檢閱和訪客存取。

串流 URLs的運作方式

串流 URL 會將串流群組 （執行串流的容量） 與該串流群組中的一個應用程式 （要執行的內容） 連結在一起。當您建立串流 URL 時，Amazon GameLift Streams 會傳回下列格式的串流 URL：

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

工作流程有四個步驟：

由於串流 URL 未經驗證，最終使用者永遠不會看到或需要您的 AWS 登入資料。服務會根據您在建立時設定的串流位置偏好設定，將每位最終使用者路由到附近的位置。Amazon GameLift Streams 會依鄰近程度重新排序您偏好的串流位置，但絕不會新增您未包含的位置。

最終使用者體驗

與 共用串流 URL 的使用者不需要安裝 AWS 帳戶 或任何軟體。他們會在支援的 Web 瀏覽器中開啟 URL，並從 Amazon GameLift Streams 為您託管的網頁串流。串流使用 WebRTC，並且具有與 Amazon GameLift Streams Web SDK 用戶端相同的瀏覽器和裝置需求。如需支援的瀏覽器和最低版本，請參閱 Amazon GameLift Streams 相容裝置和瀏覽器。如果串流群組在最終使用者開啟 URL 時沒有可用的容量，頁面會顯示串流暫時處於容量的訊息，而最終使用者可以重試。如果最終使用者嘗試關閉或重新載入標籤，頁面會提示他們確認，因為離開頁面會結束工作階段。

先決條件

建立串流 URL 之前，您需要下列項目：

建立串流 URL

下列 AWS CLI 範例會為串流群組中的應用程式建立串流 URL。串流 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"

成功呼叫會傳回串流 URL 資源，包括其 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 啟動的每個工作階段。

監控您的串流 URLs

使用 GetStreamUrl 擷取單一串流 URL。使用 指定串流群組，--identifier並使用 指定串流 URL --stream-url-identifier（串流 URL ID 或 ARN)。除了串流 URL 的組態、目前 Status和 RemainingUses之外，回應還包含從中啟動的工作階段StreamSessions清單，讓您可以查看誰正在主動串流。

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

使用 ListStreamUrls 列舉您帳戶中URLs。您可以依串流群組Status和 進行篩選，並使用 MaxResults(1–100，預設 25) 和 分頁結果NextToken。

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

您也可以在 CloudTrail 中稽核串流 URL 管理活動。CloudTrail 會將對 CreateStreamUrl、ListStreamUrls、 GetStreamUrl和 的呼叫記錄RevokeStreamUrl為資料事件。開啟串流 URL 並啟動工作階段的最終使用者不是您的 API 呼叫之一，也不會記錄為客戶 CloudTrail 活動。如需詳細資訊，請參閱使用 記錄 Amazon GameLift Streams API 呼叫 AWS CloudTrail。

撤銷串流 URL

當您想要停止串流 URL 以啟動任何其他工作階段時，例如預覽期間結束或可能無意間共用。

RevokeStreamUrl 接受 RevocationMode：

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

撤銷的串流 URL 會轉換為 REVOKED 狀態，且無法重新啟用。如果您需要繼續共用，請建立新的串流 URL。

刪除相依的資源時，Amazon GameLift Streams 也會自動撤銷串流 URL。刪除串流群組會撤銷該串流群組上的所有串流 URLs，而刪除應用程式會撤銷參考該應用程式的所有串流 URLs。在這兩種情況下，串流 URL 會移至 ，REVOKED並具有識別已刪除資源的狀態原因。

串流 URL 生命週期和狀態

串流 URL 會在建立ACTIVE時以這種方式保留，直到過期、用盡或遭到撤銷為止。離開該狀態ACTIVE後，它永遠不會返回 。

當串流 URL 為 GetStreamUrl時REVOKED， ListStreamUrls 也會傳回說明原因的狀態原因。

與從 StartStreamSession 開始的工作階段的差異

從串流 URL 開始的工作階段會與您開始的工作階段在相同的基礎設施上執行，但會針對簡短的切換、單一檢視器播放進行調校。請謹記這些差異：

疑難排解

Amazon GameLift Streams 刻意從最終使用者隱藏串流 URL 啟用失敗的特定原因。開啟無法啟動串流的串流 URL 的最終使用者一律會看到一般「找不到」頁面或「容量」訊息，無論根本原因為何。若要診斷實際原因，請使用 GetStreamUrl和 從建立者端檢查串流 URLListStreamUrls、檢查 Status和 狀態原因，並在 CloudTrail 中檢閱串流 URL API 活動。