ドキュメント

Webshop の制限リファレンス

Unity Webshop に適用される構造、ネーミング、メディア、ランタイムの制限について説明します。
読み終わるまでの所要時間 16 分最終更新 2ヶ月前

このページでは、Unity Webshop に適用される制限を列挙します。これらの制限によって制約される概念については、Webshop の概要、および Webshop のテーマとブランドを参照してください。

構造的限界

以下の制限は、作成できる Webshop、環境、およびスタジオの数に適用できます。

object

--limit

ノート

Unity Cloud プロジェクトごとの Webshop1同じプロジェクトに別の Webshop を作成すると、競合反応が返されます。
ウェブショップあたりの環境数25本番環境が含まれます。
公開環境本番環境のみ非本番環境ではドラフトのみ。本番環境に適用を使用して、本番環境以外のドラフトを本番環境にコピーします。
スタジオスコープUnity 組織ごとに 1 つ最初のウェブショップ作成時に設定されます。組織設定から名前を変更できますが、組織間で転送することはできません。

命名規則

以下の規則は、スタジオ名、ナメクジ、および設定するその他の識別子に適用されます。

フィールド

ルール

Studio name (スタジオ名):
^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$
(3 ~ 64 文字。小文字、数字、ハイフンは使用できません。)Unity 全体で一意のグローバル。
ナメクジ
^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$
(3 ~ 64 文字。小文字、数字、ハイフンは使用できません。)スタジオ内で一意の
Display name (表示名)
ディープリンク最大 31 文字(末尾に
://
を付けて 34 文字)、パターン
^[a-z][a-z0-9+.\-]{0,30}(?:://)?$
(小文字で開始する必要があります。小文字、数字、
+
.
、および
-
のみ)
javascript
data
vbscript
file
blob
、および
about
の値が拒否されます。
ディープリンク最大 512 文字

メディアの制限

Unity Dashboard では、Webshop 用に以下の画像アップロード タイプがサポートされています。
  • ヒーローバナー:ウェブショップのプレイヤーに表示されます。
  • **サムネイル:**ウェブショップのプレイヤーに表示されます。
  • Screenshots (スクリーンショット): AI テーマ生成のリファレンス入力として使用され、Webshop には表示されません。
すべての画像アップロード タイプがPNG、JPEG、WebP形式をサポート。Unity Dashboard は、各アップロードを保存前に再エンコードします。

アップロード:

目的

Max file size (最大ファイルサイズ)

リクエストあたりのファイル数

ノート

ヒーローバナーショップ上部に掲示5 MB1ダッシュボードはそれを 1920 × 384 ピクセル (5:1) WebP に再エンコードします。トリミングを避けるために、このアスペクト比以上でアップロードします。
サムネイルリンクプレビューとリンクカードで使用5 MB1ダッシュボードはそれを 48 × 48 ピクセル(正方形形)の WebP に再エンコードします。
スクリーンショット:AIテーマ生成のリファレンスファイルあたり 2 MBリクエストあたり最大6個ショップでは表示されません。テーマジェネレータへの追加入力としてのみ使用されます。1回のアップロード リクエストで、すべてのスクリーンショットの合計で最大10 MBまで転送できます。

ランタイム制限

以下の制限は、ライブ トラフィックと API 呼び出しに適用。

--limit

ノート

ダッシュボードボードのプレビュートークン発行から72時間Dev プレビュー URL(
?token=
)の署名付きトークン。レビューサイクルごとに新しいリンクを生成します。
SDK ドラフトプレビュー発行から約1時間ゲームでドラフトが解決されたときに storefront-link エンドポイントによって返される短期ドラフト URL。SDKは起動のたびにそれを再解決するため、生存期間の短さはプレイヤーから見えません。
プレイヤーセッショントークン短期間の 1 回限りの使用制限付きプレイヤー認証トークンは、ゲームによって生成され(
GenerateRestrictedTokenAsync
あり)、ショップを開くための
sessionToken
として追加されます。生存期間と 1 回限りのプロパティーはゲームによって設定されます。将来の Unity SDK メソッドで管理されます。ショップは、ブラウザーでプレイヤーセッションのために1回それを交換します。Unity ゲームへの Webshop の統合 を参照してください。
プレイヤー ID トークン1 時間。自動的に更新されます。Webshopでは、有効期限が切れる直前にプレイヤーのIDトークンが更新されるため、プレイヤーがセッションの途中で再認証されることはありません。
プレイヤーセッション固定の有効期限はありません。プレイヤー セッションは、サーバーが取り消すまで有効です。Webshop は、ライブショップの
localStorage
、ダッシュボードのプレビューパスの
sessionStorage
など、プロジェクトと環境に応じてブラウザーにそれを保持します。
管理 API レート制限ソース IP ごとに 40 リクエスト/秒。すべての内部 API 呼び出し (ダッシュボードボードリクエスト、サービスアカウントプログラマティックコール) に適用されます。制限を超えたバースト自動化は
429 Too Many Requests
されます。
プレイヤーカタログのリクエスト制限600リクエスト/分(プレイヤー、プロジェクト、環境)、IPあたり20リクエスト/分、300リクエスト/分のバックストッププレイヤーフロントエンドのランタイムカタログフェッチに適用されます。この 2 つの制限によってスタックが制限されるため、1 人の動作不良プレイヤーが IP の許容範囲を使い果たすことはありません。
プレイヤーシェルトラフィックサービスによるレート制限はありません。ShopのHTMLシェルとメディアはコンテンツ配信ネットワークから提供され、ダッシュボード サービスにヒットしません。

アクセスと可視性

ウェブショップは、コンテンツ配信ネットワークが静的アセットを提供するのと同様に、アップロードされたメディアと Dev プレビューをパブリックウェブコンテンツとして提供します。URL を持つ人は誰でも、サインインせずに開くことができます。URL は推測不可能な ID を使用しており、ショップからリンクされていないため、簡単に見つけることができませんが、アクセス制御もされていません。アップロードするものとプレビューを共有する相手を選択するときは、この点に留意してください。

Resource

アクセスできるユーザー

ノート

Dev プレビュー URLトークンが期限切れになるまで、リンクを持つすべてのユーザーWebshop は
/_preview/{publisher}/game/{slug}
パスでプレビューを行い、URL に署名付き期限付きトークン (
token
クエリパラメーター) を使用して承認します。描画するセッションは匿名であるため、サインインやユーザーごとの確認は行われません。トークンのみがリンクを保護します。トークンの有効期限(72時間)が切れるまで、共有者全員がドラフトをビューできます。レビューサイクルごとに新しいリンクを生成します。
アップロードされたメディア (ヒーローバナー、サムネイル、スクリーンショット)URL を持つユーザーアップロードしたメディアはWebPに再エンコードされ、パブリックオブジェクトとしてクラウドストレージバケットに格納されます。このバケットは、ショップの
_media/
パス(例えば
https://shop.unity.com/_media/{projectId}/branding/logo.webp
)のコンテンツ配信ネットワークを通じて提供されます。リクエストごとの認証はなく、オブジェクトはパブリックにキャッシュされます。ブランドファイルは固定名を使用し、スクリーンショットはコンテンツハッシュ名を使用するため、パス内のプロジェクトIDのみが推測できない部分です。URLがあれば誰でもファイルを開くことができます。アップロードされたメディアをパブリック表示として扱います。

AI テーマの生成

以下の値は AI テーマの生成に適用。

Detail (詳細)

現在の値

テーマの生成に使用されるモデル大規模な言語モデル(より優れたモデルが利用可能になり次第変更される可能性があります)
生成入力のソース指定する Apple App Store リスト URL、アップロードするスクリーンショット、またはその両方。ダッシュボードボードは、アイコン、スクリーンショット、色パレットの指定されたリストをスクレイピングします。
テーマ生成レート制限乱用防止策として、プロジェクトごとにレートが制限されています。制限は法線を超えるインタラクティブ使用に設定されており、ダッシュボードで許可されている速度に達するまでテーマの生成と調整ができないため、無茶な自動化にのみ影響します。それを超える要求は
429 Too Many Requests
を返します。
テーマ生成バジェットテーマ生成に対するプロジェクトごとの日予算と週予算の上限。プロジェクトが上限に達すると、ウィンドウがリセットされるまで後続の生成がブロックされます。この上限はプロジェクトごとに追跡され、Webshop を削除して再作成してもリセットされません。
このジェネレータを使用するユーザー向けの手順については、AI による Webshop テーマの生成 を参照してください。