인터랙티브 사이트 구축하기
https://{prefix}.interactive.vidmoat.com 사이트는 사용자 자신의 인터랙티브 비디오를 주변 요소 없이 보여주는 공간입니다. 비디오가 핵심이고, 사이트는 프레임 역할을 합니다. 모든 페이지는 방문자가 한 화면 안에서 플레이어에 도달하도록 해야 합니다.
사용할 도구: 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_interactivewithshare: true)하며, 임의로 추측하거나 다른 비디오로 대체하지 않습니다. - 한 번 이름 짓기.
get_interactive_site와prefix: "name"으로 이름을 확인하고(한두 번 시도로 제한, 아이디어 반복 금지), 그 후edit_interactive_site에create: {prefix, title}을 사용합니다. 사용자 본인의 이름이나 브랜드를 사용하며, 계정당 하나의 사이트만 생성됩니다. - 하나의 테마.
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(제목, 한 줄 설명, 가장 강력한 비디오를video로, 버튼), 나머지를 위한grid, 그 다음 설명 섹션 (분기 영화를 위한story,text,about), 마지막에cta또는links. 한 개의 추천 비디오만 표시, 세 개 안 됨. - 적은 페이지. 보통 홈 페이지만으로 충분합니다. 한 화면을 넘는 내용이 있을 때만
films또는about페이지를 추가합니다.setNav로 페이지 목록을 설정하고,setHeader로 제목, 태그라인, 로고(images: true로부터)를 제공합니다. - 일괄 편집. 모든
ops를 포함한 한 번의edit_interactive_site호출(모두 적용되거나 모두 실패), 그 후 응답의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은images: true에서 가져온 이미지 ID를 사용하며, URL 사용 불가.- 액센트 색상이 거부될 수 있음 해당 색상 위의 텍스트나 페이지가 읽기 어려울 경우. 다크에는 밝은 액센트, 라이트에는 어두운 액센트를 시도하세요.
- 제한 초과 시 잘리지 않고 거부됨: 페이지 6개, 페이지당 섹션 12개, 그리드당 비디오 12개, 내비게이션 링크 6개, 링크 10개; 제목 90자, 본문 600자. 직접 단어를 줄이세요.
null은updateSection에서 선택 필드를 제거하며, 생략하면 유지됩니다.- 검색 엔진이 게시된 사이트를 찾을 수 있음 (사이트맵 및 비디오 데이터 포함). 각 페이지의
title과description을 낯선 사람이 검색할 때를 대비해 작성하세요.setSettingsindexing: false는 사이트를 비공개로 유지하고 싶을 때 사용합니다. - 스토리 맵은 게임의 재미를 망칩니다. 기본적으로 오프닝과 선택지만 표시되며, 장면과 엔딩 수는 집계됩니다.
reveal: "full"은 수업이나 안내서에만 사용하고, 게임이나 미스터리에는 절대 사용하지 마세요. 비밀을 약속하는 문구 옆에도 사용하지 마세요. - 포스터가 중요합니다. 플레이어와 그리드 카드는 재생되기 전까지 비디오의 포스터를 보여줍니다. 포스터가 실제 타이틀 카드인 비디오를 선택하고, 검은색 첫 프레임은 피하세요.
- 주소 변경 (
edit_interactive_sitewithprefix)은 이전 이름을 유지하고 일정 기간 동안 리디렉션합니다. 가볍게 변경하지 마세요. - 취미 계정은 거부 사유와 함께 거부됩니다. 명확히 말하고, 우회하지 마세요.