API 參考

Video

放置選定簡報 assets 資料夾中的可攜影片圖層。

presentation.tsx

<Video id="demo" x={8} y={24} w={84} h={52} src="assets/demo.mp4" poster="assets/demo-poster.webp" />

屬性參考

屬性值應保持字面且可序列化，才能由 Canvas、Inspector、驗證與匯出流程可靠處理。

API	屬性	型別／值	必要	說明
所有原生圖層共用 props	id	string	是	穩定且唯一的圖層識別字。每個可見的原生圖層都必須提供。
	x	number	是	相對於投影片畫布左側的位置百分比。
	y	number	是	相對於投影片畫布頂端的位置百分比。
	w	number	是	圖層寬度，單位為畫布百分比。
	h	number	是	圖層高度，單位為畫布百分比。
	groupId	string	—	在不加入 wrapper 元素的情況下，將原生子圖層編組。
	groupName	string	—	在 Workbench 顯示的群組名稱。
	sharedId	string	—	連接相鄰 Morph 投影片中的同型圖層；在同一張投影片內必須唯一。
	rotation	number	—	順時針旋轉角度。
	opacity	number	—	圖層不透明度，範圍為 0 到 1。
	motion	JSON string	—	版本化的宣告式動作序列 JSON 字串；仍須保留完整的靜態最終畫面。
	interaction	JSON string	—	版本化的點擊互動 JSON 字串，可用於投影片導覽或連結。
Video	src	string	是	本機 MP4/WebM 路徑、直接 URL 或支援的 YouTube URL。
	poster	string	—	播放前或靜態 render 時顯示的圖片。
	fit	cover \| contain \| fill \| scale-down	—	影片內容填滿框架的方式。
	controls	boolean	—	是否顯示播放控制項；預設為 true。
	loop	boolean	—	是否循環播放；預設為 true。
	muted	boolean	—	是否靜音並啟用 inline autoplay；預設為 true。
	radius	number	—	框架圓角半徑。

使用 id、x、y、w、h 以及已驗證的相對 src；OpenSlideX 的可攜影片使用本機 MP4 素材。

poster 可指向播放前顯示的本機圖片；影片與 poster 都留在簡報內，不要連結到不透明的電腦路徑。