キャストアバター VRM アップロード手順

キャストアバター（VRM）は専用のアップロード API がなく、Azure Blob Storage に直接配置する。 読み取りは GetCastAvatarReadUrl が発行する SAS URL 経由になるため、ファイル自体は Blob Storage に存在している必要がある。

BlobPath の確認

PlayFab ダッシュボード → 対象環境タイトル → Players → 対象キャストユーザー → Player Data
CastAvatarBlobPath（例：cast-avatars/xxxUserId/avatar.vrm）を確認する。

アップロード方法

Azure Portal（推奨）

  1. Azure Portal → ストレージアカウント（環境別）→ コンテナ cast-avatars
  2. BlobPath に合わせたパスに VRM ファイルをアップロード

azcopy（Dev → Stg コピー）

Dev の VRM を Stg にそのままコピーする場合、各ストレージアカウントの SAS を取得してから実行する。

# SAS は Azure Portal → ストレージアカウント → Shared Access Signature で取得
azcopy copy \
  "https://<dev-storage>.blob.core.windows.net/cast-avatars?<SAS読み取り>" \
  "https://<stg-storage>.blob.core.windows.net/cast-avatars?<SAS書き込み>" \
  --recursive

SAS に必要な権限：

  • コピー元（Dev）：読み取り（Read）、一覧（List）
  • コピー先（Stg）：書き込み（Write）、作成（Create）

環境別ストレージアカウント名

D:\GakugekiResources\IaC\infra\params\ 内の各環境の .bicepparam を参照。

注意

  • SAS の有効期限は短めに設定すること（Portal 既定は 8 時間）
  • GetCastAvatarReadUrl が発行する読み取り SAS の有効期限は 15 分（CAST_AVATAR_SAS_EXPIRY_MINUTES）
  • cast-avatars 以外のコンテナは CAST_AVATAR_ALLOWED_CONTAINERS で制限されており、アクセス拒否になる
Edit this page