跳到內容

Slide 內容版本、元素、主題與限制

投影片 body 是帶頂層 versionelements 的 JSON。runtime 接受 legacy version 1 與 canonical version 2,不存在 version 3;新空白頁使用 version 2 與空陣列。元素類型為 textimageshaperect/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:94:3。相對地,只要必要 base 與 type-specific 欄位有效,單一 element 內的未知額外 key 會刻意保留,以維持向前相容;read-modify-write 時不要把這些擴充欄位剝除。

arinova.slide.create_deck, arinova.slide.get_deck, arinova.slide.add_slide, arinova.slide.update_slide

Also known as

簡報 JSON, 內容版本, 文字圖形表格, 元素上限, 簡報主題, 長寬比


Machine-readable Markdown · Knowledge index

Build a7f47a5ca54ddcf7806cd48b81ce1b9827042766