您應用程式的 AWS 登入資料

若要讓您的應用程式存取您帳戶中的 AWS 資源，例如 Amazon S3 儲存貯體、DynamoDB 資料表或其他 AWS 服務，請在啟動串流工作階段時提供 IAM 角色 ARN。Amazon GameLift Streams 會擔任該角色，並自動為您的應用程式提供登入資料。

若要設定工作階段登入資料，請在呼叫 StartStreamSession 時傳遞 --role-arn 參數。下列範例顯示從 Amazon S3 下載組態檔案，然後啟動應用程式的 Windows 啟動指令碼 (.bat 檔案）：

REM --- Configuration ---
SET "S3_CONFIG_PATH=s3://my-app-bucket/configs/app-config.json"
SET "LOCAL_CONFIG_DIR=%TEMP%\my-app-config"
SET "LOCAL_CONFIG_FILE=%LOCAL_CONFIG_DIR%\app-config.json"

REM --- Create local directory if it doesn't exist ---
IF NOT EXIST "%LOCAL_CONFIG_DIR%" (mkdir "%LOCAL_CONFIG_DIR%")

REM --- Download configuration file from S3 ---
echo Downloading configuration from %S3_CONFIG_PATH%...
aws s3 cp "%S3_CONFIG_PATH%" "%LOCAL_CONFIG_FILE%"
IF %ERRORLEVEL% NEQ 0 (
    echo ERROR: Failed to download configuration file from S3.
    exit /b 1
)
echo Configuration downloaded to %LOCAL_CONFIG_FILE%.

REM --- Launch the application with config file ---
echo Starting application...
my-app.exe --config "%LOCAL_CONFIG_FILE%" %*
exit /b %ERRORLEVEL%

您不需要變更應用程式程式碼。AWS CLI 和所有 AWS SDKs會透過 AWS 開發套件憑證提供者鏈自動探索並使用憑證。

AWS CLI 2.35.11 版適用於所有 Amazon GameLift Streams 執行期環境 (Windows、Ubuntu 和 Proton)。AWS CLI 和所有 AWS SDKs會在工作階段的生命週期內自動重新整理登入資料。

如需完整的設定指南，包括建立 IAM 角色、信任政策和故障診斷，請參閱 將 AWS 登入資料提供給串流應用程式。