翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ストリーム URLs でストリームセッションを共有する

ストリーム URLs を使用すると、ストリームセッションを他のユーザーとすばやく共有できます。受信者は、サポートされているウェブブラウザで AWS アカウント または クライアントの統合を必要とせずにストリームセッションにアクセスし、有効期限、使用状況、失効を制御します。ストリーム URL を作成した後、それにアクセスするすべてのユーザーは、認証情報を必要とせずに独自のストリームセッションを開始します。ストリーム URLsは、デモ、プレイテスト、ステークホルダーレビュー、ゲストアクセスを迅速かつ簡単にセットアップするのに最適です。

ストリーム URLs仕組み

ストリーム URL は、ストリームグループ (ストリームを実行する容量) と、そのストリームグループ内の 1 つのアプリケーション (実行するコンテンツ) を結び付けます。ストリーム URL を作成すると、Amazon GameLift Streams は次の形式のストリーム URL を返します。

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

ワークフローには 4 つのステップがあります。

ストリーム URL は認証されていないため、エンドユーザーが AWS 認証情報を表示したり必要としたりすることはありません。このサービスは、作成時に設定したストリーミングロケーション設定に基づいて、各エンドユーザーを近くの場所にルーティングします。Amazon GameLift Streams は、希望するストリーミングロケーションを近接で並べ替えますが、含めなかったロケーションを追加することはありません。

エンドユーザーエクスペリエンス

ストリーム URL を共有するユーザーには、 AWS アカウント やソフトウェアのインストールは必要ありません。サポートされているウェブブラウザで URL を開き、Amazon GameLift Streams がホストするウェブページからストリーミングします。ストリーミングは WebRTC を使用し、ブラウザとデバイスの要件は Amazon GameLift Streams Web SDK クライアントと同じです。サポートされているブラウザと最小バージョンについては、「」を参照してくださいAmazon GameLift Streams 互換デバイスとブラウザ。エンドユーザーが URL を開くときにストリームグループに使用可能な容量がない場合、このページにはストリームが一時的に容量に達しており、エンドユーザーは再試行できるというメッセージが表示されます。エンドユーザーがタブを閉じたり再ロードしようとすると、ページを離れるとセッションが終了するため、確認を求められます。

前提条件

ストリーム URL を作成する前に、以下が必要です。

ストリーム URL の作成

次の の AWS CLI 例では、ストリームグループ内のアプリケーションのストリーム URL を作成します。ストリーム URL は 2 時間有効で、最大 5 回使用できます。 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 を使用して 1 つのストリーム URL を取得します。でストリームグループを指定--identifierし、 --stream-url-identifier (ストリーム URL ID または ARN) でストリーム URL を指定します。ストリーム 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 コールの 1 つではなく、顧客の 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 が の場合REVOKED、 GetStreamUrl は理由を説明するステータスの理由ListStreamUrlsも返します。

StartStreamSession で開始するセッションとの違い

ストリーム URL から開始されたセッションは、自分で開始したセッションと同じインフラストラクチャで実行されますが、短いハンドオフのシングルビューワー再生用に調整されます。これらの違いに注意してください。

トラブルシューティング

Amazon GameLift Streams は、ストリーム URL のアクティベーションが失敗した特定の理由をエンドユーザーから意図的に非表示にします。ストリームを開始できないストリーム URL を開くエンドユーザーは、根本的な原因に関係なく、常に一般的な「見つからない」ページまたは「容量」メッセージを表示します。実際の原因を診断するには、作成者側のストリーム URL を GetStreamUrlと で検査しListStreamUrls、Statusステータスの理由と を確認し、CloudTrail でストリーム URL API アクティビティを確認します。