インタラクティブサイトの構築
https://{prefix}.interactive.vidmoat.com にあるサイトは、ユーザー自身のインタラクティブ動画を、周りに余計なものを一切配置せずに表示するホームです。動画が主役であり、サイトはそのフレームです。すべてのページは、訪問者を1画面以内でプレイヤーに導く必要があります。
ツール: get_interactive_site、edit_interactive_site、publish_interactive_site(MCPおよびAPI)。アプリ内では、同じ呼び出しは agentWorkspace を通じて action: "interactive_site" と site: {tool, ...arguments} で実行されます。
ワークフロー
- まず読み取る。
videos: trueを指定してget_interactive_siteを実行します。これによりサイトが存在するか (canCreate)、そのページと各sectionId、問題 (problems)、リビジョン番号 (rev) がわかります。依頼されたものだけをsectionIdで変更し、revを返送します。 - 公開済みで共有設定された動画のみ。 サイトには、アカウント自身のインタラクティブ動画で、選択肢が公開され共有設定されたものだけが表示されます。
videos: trueはそれらの動画をIDとともに一覧表示します。ユーザーが指定した動画がリストにない場合は、まず公開します(同意を得た上でpublish_interactiveをshare: trueで実行)。推測したり別の動画とすり替えたりしてはいけません。 - 名前は一度決める。
get_interactive_siteにprefix: "名前"を指定して名前を確認し(制限: 1~2回の試行、アイデアを繰り返し提案しない)、その後edit_interactive_siteでcreate: {prefix, title}を実行します。ユーザー自身の名前やブランドを使用します。アカウントにつき1サイトです。 - 1つのテーマ。
setTheme:tone(dark,light)、palette(warm,neutral,cool,forest,plum)、fontとheadingFont(system,serif,mono,rounded)、corners(soft,round,square)、density(comfortable,compact,airy)、width(normal,narrow,wide)、playerAccent(videoは各動画の外観を維持、siteはサイトのものを使用)、accent#RRGGBB。映像に合わせます。ダークは映画的な映像や夜間の映像に、ライトはチュートリアルやコースに適しています。トークンを省略するとデフォルト値が維持されます。 - ホームページはこの順序で:
hero(見出し、1行、最も強い動画をvideoとして、ボタン)、次に残りの動画のgrid、次に説明(分岐する映画にはstory、text、about)、最後にctaまたはlinks。注目動画は1つだけ、3つではありません。 - ページは少数に。 ホームだけでも十分なことがよくあります。それが1画面以上になる場合にのみ
filmsやaboutページを追加します。setNavでそれらをリスト表示します。setHeaderでタイトル、タグライン、images: trueからのロゴを設定します。 - 編集は一括で。 1回の
edit_interactive_site呼び出しですべてのops(すべて適用されるか、まったく適用されない)を送信し、応答のproblemsを読み取ります。 - プレビューしてから公開。 ユーザーに
previewUrl(実際のアドレスでのドラフト、1時間有効)を提供します。publish_interactive_siteはユーザーが明示的に要求した場合のみ実行します。公開ページになるためです。publish: falseですぐに非公開にできます。
例
{"create": {"prefix": "river-films", "title": "River Films"}}
{"rev": 3, "ops": [
{"op": "setTheme", "tone": "dark", "palette": "cool", "headingFont": "serif", "accent": "#4CC9F0"},
{"op": "setHeader", "title": "River Films", "tagline": "Short films you play"},
{"op": "addPage", "slug": "films", "title": "Films"},
{"op": "setNav", "links": [{"label": "Home", "page": ""}, {"label": "Films", "page": "films"}]},
{"op": "addSection", "page": "", "section": {"kind": "hero", "heading": "Films where you choose what happens next", "body": "Pick a path, then go back and take the other one.", "video": "<videos:true からのID>", "cta": {"label": "See every film", "page": "films"}}},
{"op": "addSection", "page": "", "section": {"kind": "grid", "heading": "Play them all", "videos": ["<ID>", "<ID>"], "columns": 3}},
{"op": "addSection", "page": "", "section": {"kind": "story", "video": "<ID>", "heading": "How it branches"}}
]}
{"rev": 4, "ops": [{"op": "updateSection", "sectionId": "<ダイジェストから>", "set": {"heading": "New films every month", "body": null}}]}
注意点
- カスタムコードは不可。 HTML、CSS、スクリプト、埋め込み、"カスタムスタイリング" は一切使用できません。提供してはいけません。拒否された値は許可リストとともに返されるので、そこから選択してください。
- ページ
""はホーム。 その他のページはスラッグ(films、about)です。スラッグ名を変更すると、そのリンクも自動的に追随します。 - ボタン(
cta)は{label, page}または{label, href}(httpsアドレス)です。linksは https のみです。 textは制限付きマークダウン:##と###、リスト、太字、斜体、https リンク。HTML や画像は使用できません。aboutは画像ID をimages: trueから受け取ります。URL は不可です。- アクセントカラーは拒否されることがあります。 文字やページとのコントラストが低く読みにくい場合です。ダークテーマでは明るめのアクセント、ライトテーマでは濃いめのアクセントを試してください。
- 制限は拒否され、切り詰められることはありません。 6ページ、1ページあたり12セクション、1グリッドあたり12動画、6ナビゲーションリンク、10リンク。見出しは90文字、本文は600文字。自分で短くしてください。
nullは削除 を意味します。updateSectionでオプションフィールドを削除する場合に使用します。省略するとそのまま維持されます。- 公開されたサイトは検索エンジンに見つかることがあります(サイトマップと動画データが付随します)。各ページの
titleとdescriptionは、見知らぬ人が検索したときのために記述してください。setSettingsでindexing: falseにすると、ユーザーが非公開にしたいときにサイトを検索対象から外せます。 - ストーリーマップはゲームの楽しみを損ねます。 デフォルトでは冒頭とその選択肢のみを表示し、シーン数と結末数をカウントします。レッスンやガイドの場合にのみ
reveal: "full"を使用し、ゲームやミステリーでは絶対に使用せず、秘密を約束するコピーの横にも配置しないでください。 - ポスターは重要です。 プレイヤーやグリッドカードは、再生されるまで動画のポスターを表示します。ポスターが実際のタイトルカードであり、黒い最初のフレームではない動画を選んでください。
- アドレスの変更(
edit_interactive_siteでprefixを変更)は、古い名前を保持し、しばらくの間転送します。安易に変更しないでください。 - 趣味アカウントは理由とともに拒否されます。 その旨を率直に伝え、回避しようとしないでください。