Slide 內容版本、元素、主題與限制
投影片 body 是帶頂層 version 與 elements 的 JSON。runtime 接受 legacy version 1 與 canonical version 2,不存在 version 3;新空白頁使用 version 2 與空陣列。元素類型為 text、image、shape(rect/ellipse)、table。每個元素需有 slide 內唯一的非空 ID,以及有限的 x、y、width、height;width/height 必須為正。各類型欄位另行驗證,圖片規則見專屬卡。
每個 deck 最多 200 slides,每張最多 200 elements,serialized content 最多 256 KiB(262,144 bytes);這些是行為常數。table 是 rows 陣列,列、欄與 cell text 超限會回 invalid_arguments,細節以 runtime error 為準。text 與 speakerNotes 過長也會被拒;長文應拆成多頁或改用 Memo。Action envelope 的最新形狀查 arinova.action.get_schema。
deck theme 是獨立 metadata object,採已知 key 的嚴格 allowlist,且巢狀 JSON value 必須安全;未知 theme key 會被拒絕。預設長寬比僅接受 16:9 或 4:3。相對地,只要必要 base 與 type-specific 欄位有效,單一 element 內的未知額外 key 會刻意保留,以維持向前相容;read-modify-write 時不要把這些擴充欄位剝除。
Related actions
Section titled “Related actions”arinova.slide.create_deck, arinova.slide.get_deck, arinova.slide.add_slide, arinova.slide.update_slide
Also known as
簡報 JSON, 內容版本, 文字圖形表格, 元素上限, 簡報主題, 長寬比
Build a7f47a5ca54ddcf7806cd48b81ce1b9827042766