用 OfficeCLI 在 PPT 中嵌入视频四张幻灯片的完整实战与 OOXML 底层原理【免费下载链接】OfficeCLIOfficeCLI 是首款也是最佳的专为 AI 代理设计的命令行工具可用于读取、编辑和自动化处理 Word、Excel 和 PowerPoint 文件。它免费、开源仅包含一个二进制文件无需安装 Office 套件。项目地址: https://gitcode.com/iOfficeAI/OfficeCLIOfficeCLI 是专为 AI 代理设计的命令行工具可在不安装 Office 套件的情况下读取、编辑和自动化处理 Word、Excel 与 PowerPoint 文件。本篇技术指南以仓库中的 examples/ppt/video.md 为骨架完整讲解如何在 PowerPointPPTX中嵌入 MP4 视频、设置封面图poster、控制音量与自动播放、实现循环与裁剪播放并通过源码级分析揭示这些命令背后的 OOXML 实现原理。读完本文你将掌握officecli的--type video元素全参数用法、可复现的构建脚本以及从命令行、Python SDK 两种方式生成含视频演示文稿的完整方案。一、示例概览三个文件协同工作examples/ppt/video.md对应的完整示例由三个文件组成video.py—— Python 构建脚本。先用imageio现场合成一段 MP4 测试视频再通过officecli Python SDKpip install officecli-sdk构建一个嵌入视频的 4 页演示文稿每次officecli调用都会输出到 stdout。video.sh—— 与 video.py 等价的CLI 版脚本。两者生成完全等效的video.pptx。脚本故意不设置set -e与 SDK 版的doc.batch(...)一样容忍前向兼容的 UNSUPPORTED props 警告officecli 退出码 2继续构建完整文档。video.md—— 本文档将每张幻灯片映射到它演示的视频嵌入功能。从源码结构看SDK 版的doc.batch([...])中每个条目都是与officecli batch列表完全相同的{command, parent/path, type, props}字典因此两种方式在语义上是同一套命令面。二、环境准备与重新生成在examples/ppt目录下执行cd examples/ppt pip install imageio imageio-ffmpeg numpy python3 video.py # → video.pptx脚本会生成一段3 秒、640×360 的 MP4内容为动态渐变背景 移动圆球提取第一帧作为封面 PNG将两者嵌入 PPTX 后自动清理临时文件。若未安装imageio脚本会打印明确提示ERROR: imageio not installed. Run: pip install imageio imageio-ffmpeg numpyvideo.sh的用法为./video.sh [officecli path]可选参数用于指定 officecli 可执行文件路径默认使用 PATH 中的officecli。生成后脚本还会自动执行officecli validate $FILE做一次校验。三、Slide 1 —— 标题页径向渐变背景与占位符第 1 页演示了基于layouttitle版式的占位符型幻灯片配合radial径向渐变背景officecli add video.pptx / --type slide --prop layouttitle officecli set video.pptx /slide[1] --prop backgroundradial:1B2838-4472C4-bl officecli set video.pptx /slide[1]/placeholder[ctrTitle] \ --prop textVideo Demo --prop colorFFFFFF --prop size44 officecli set video.pptx /slide[1]/placeholder[subTitle] \ --prop textEmbedded video with officecli --prop colorB4C7E7 --prop size20涉及功能layouttitle占位符型幻灯片、backgroundradial:color1-color2-corner渐变背景、placeholder[ctrTitle]/[subTitle]占位符寻址、color文字颜色、size字号。其中渐变背景格式radial:1B2838-4472C4-bl表示径向渐变起始色#1B2838结束色#4472C4渐变方向/落点由末尾的blbottom-left指定。四、Slide 2 —— 嵌入视频自动播放与音量这是核心视频演示页。MP4 通过src嵌入 PPTX 包内用poster指定播放前显示的静态封面并开启自动播放officecli add video.pptx / --type slide --prop titleAnimated Video officecli set video.pptx /slide[2] --prop background0D1B2A officecli set video.pptx /slide[2]/shape[1] --prop colorFFFFFF officecli add video.pptx /slide[2] --type video \ --prop src/path/to/demo.mp4 \ --prop poster/path/to/cover.png \ --prop x2cm --prop y4cm --prop width22cm --prop height12.5cm \ --prop volume80 \ --prop autoplaytrue各属性语义属性类型说明src路径把 MP4 嵌入 PPTX 包内可传文件路径、URL 或>officecli add video.pptx / --type slide --prop titleVideo Properties officecli set video.pptx /slide[3] --prop background1B2838 officecli set video.pptx /slide[3]/shape[1] --prop colorFFFFFF # 信息框带 \n 换行的多行文本等宽字体 officecli add video.pptx /slide[3] --type shape \ --prop textResolution: 640x360\nFPS: 30\nDuration: 3s\nFormat: MP4 \ --prop fontConsolas --prop size16 --prop colorB4C7E7 \ --prop x1cm --prop y4cm --prop width10cm --prop height6cm \ --prop fill0D1B2A --prop line4472C4 --prop linewidth1pt # 柱状图帧颜色分析 officecli add video.pptx /slide[3] --type chart \ --prop chartTypebar \ --prop titleFrame Colors \ --prop categoriesRed,Green,Blue \ --prop series1Start:20,30,200 \ --prop series2End:80,30,80 \ --prop colorsE74C3C,27AE60 \ --prop x13cm --prop y4cm --prop width12cm --prop height8cm涉及功能--type shape多行文本\n换行、fontConsolas等宽字体、line/linewidth形状边框、fill形状填充以及--type chart的chartTypebar柱状图、series1名称:v1,v2,…系列数据、categories分类轴、colors系列颜色——这些能力可与视频元素共存于同一幻灯片。图表系列格式series1Start:20,30,200表示系列名 Start、三个数据点若完全不提供数据officecli会提示Chart requires data. Use: dataSeries1:1,2,3;Series2:4,5,6 or series1Revenue:100,200,300。六、Slide 4 —— loop / trimStart / trimEnd 播放控制第 4 页演示循环与裁剪的组合视频在源文件的子区间3 秒视频中仅播放 0–2 秒内无限循环officecli add video.pptx / --type slide --prop titleloop / trimStart / trimEnd officecli set video.pptx /slide[4] --prop background0D1B2A officecli set video.pptx /slide[4]/shape[1] --prop colorFFFFFF officecli add video.pptx /slide[4] --type video \ --prop src/path/to/demo.mp4 \ --prop poster/path/to/cover.png \ --prop x2cm --prop y4cm --prop width22cm --prop height12.5cm \ --prop volume60 \ --prop autoplaytrue \ --prop looptrue \ --prop trimStart0 \ --prop trimEnd2 # 说明文字标注 officecli add video.pptx /slide[4] --type shape \ --prop textlooptrue trimStart0 trimEnd2\nVideo loops continuously; playback is clipped to the 0–2s range. \ --prop size14 --prop colorB4C7E7 \ --prop x1cm --prop y17cm --prop width24cm --prop height2cm属性类型效果looptruebool视频播放到结尾后重新开始trimStartNnumber秒播放从第 N 秒开始trimEndNnumber秒播放到第 N 秒停止trimStart/trimEnd会被钳制到视频实际时长范围内二者与looptrue组合即可生成循环子片段。涉及功能loop布尔、trimStart秒、trimEnd秒、trim 与 loop 的组合。trim 参数的更丰富输入形式根据 schemas/help/pptx/media.json 中的模式定义trimStart/trimEnd实际上接受三种输入形式最终统一以毫秒整数写入文件读回时也是毫秒字符串--prop trimStart1500 # 纯毫秒 --prop trimStart1.5s # 秒带 s 后缀 --prop trimStart00:00:01.500 # hh:mm:ss.fff 时间戳对应的别名是trimstart/trimend。在 PowerPointHandler.Add.Media.cs 的NormalizeMediaTimeMs中可以看到归一化逻辑含冒号的走hh:mm:ss(.fff)解析带ms/s后缀的按比例换算最终统一转为毫秒整数。七、功能覆盖总表下表来自原文档汇总了每张幻灯片演示的功能FeatureSlidelayouttitle占位符型幻灯片1backgroundradial:渐变1background纯色 hex2, 3, 4placeholder[ctrTitle]/[subTitle]1--type video元素2, 4src嵌入 MP4 到包内2, 4poster封面图2, 4volume0–1002, 4autoplay2, 4loop4trimStart/trimEnd秒4x/y/width/heightcm2, 3, 4--type shape多行文本\n3, 4fontConsolas等宽标注3line / linewidth形状边框3--type chart视频页上的柱状图3series1名称:v1,v2、colors3八、检查生成的 PPTXquery / get 回读生成后可以用officecli的查询命令回读文档结构与视频节点officecli query video.pptx slide officecli get video.pptx /slide[2] officecli get video.pptx /slide[2]/video[1] officecli get video.pptx /slide[4]/video[1]其中/slide[N]/video[M]正是 media.json 中定义的定位路径格式positional: [/slide[N]/video[M], /slide[N]/audio[M]]。src与poster仅在 add/set 时接受get 不返回src键而位置、尺寸、音量、autoplay、loop、trim 等均支持 get 回读——例如x回读为 cm 长度字符串、volume回读为百分比、trimStart回读为毫秒字符串。九、源码级原理一个--type video到底做了什么从 PowerPointHandler.Add.Media.cs 的AddMedia方法可以还原视频嵌入的完整流程类型推断typevideo强制走视频分支typemedia时按扩展名路由——.mp4/.avi/.wmv/.mpg/.mov判为视频.mp3/.wav/.wma/.m4a判为音频图片扩展名.gif/.png/.jpg等则转发到AddPicture走图片路径。内容类型映射.mp4 → video/mp4、.avi → video/x-msvideo、.mov → video/quicktime等映射表见 Add.Media.cs。创建MediaDataPart并写入二进制流Add.Media.cs。建立两类关系视频走AddVideoReferenceRelationshipAddMediaReferenceRelationship双关系音频走AddAudioReferenceRelationship。视频的实际数据由p14:media扩展PowerPoint 2010的Embed属性引用。封面图处理提供poster时按图片解析并嵌入不提供时自动生成 1×1 透明 PNG 占位图源码中以字节数组形式内嵌这与 media.json 中 Poster image auto-generated when not supplied 的说明一致。位置与尺寸显式给定x/y/width/height时按 EMU 解析缺省时默认占幻灯片宽高的 75% 并水平垂直居中。负尺寸会被拒绝Negative width is not allowed。构造Picture结构cNvPr上挂hlinkClick actionppaction://media点击播放的钩子nvPr中放VideoFromFile/AudioFromFile再追加p14:media扩展BlipFill的r:embed指向封面图。trim 归一化trimStart/trimEnd经NormalizeMediaTimeMs归一为毫秒整数写入p14:trim/st|end。源码注释特别强调PowerPoint 拒绝打开st为时间戳字面量的文件报0x80070570 file corrupted因此 wire 格式必须是毫秒整数。播放行为timing 节点volume默认 80000即 80%0–100 输入直接乘 1000 得到 0–1000000–1 区间输入如 0.8会自动放大 100 倍归一。autoplay接受autoplay/autostart别名autoStart是 PowerPoint 界面用语autoplay是既有规范名仅true不区分大小写视为开启。looptrue在播放器节点的cTn上写repeatCountindefinite对应 PowerPoint 的 Loop until Stopped默认关闭。最终由AddMediaTimingNode将上述设置写入幻灯片的时序timing树并保存。对应的set 侧修改已有视频由 PowerPointHandler.Set.Media.cs 承担其属性面src替换、位置尺寸、裁剪、效果等与 add 保持一致。十、两种驱动方式CLI 脚本与 Python SDK 等价CLI 方式video.shofficecli create→officecli open→ 逐条officecli add/set→officecli close→officecli validate。SDK 方式video.pyofficecli.create(FILE, --force)启动一个常驻resident进程通过命名管道以doc.batch([...])一次往返提交全部命令doc.send({command: get, ...})回读校验最后doc.send({command: save})落盘上下文退出时自动刷新。SDK 导入优先尝试已安装的officecli-sdk失败则回退到仓库内 sdk/python 目录的副本。两者生成完全等效的video.pptx你可以根据自动化场景任选其一。结语通过本文你已经掌握了 OfficeCLI 嵌入视频的完整命令面src/poster/volume/autoplay/loop/trimStart/trimEnd 定位尺寸、两种自动化驱动方式以及 OOXML 层面的实现细节p14:media扩展、ppaction://media点击钩子、repeatCountindefinite循环、trim 毫秒归一化等。在 AI 代理场景中你可以直接用officecli add ... --type video让代理为报告、产品演示或培训课件插入带封面、自动播放、循环子片段的视频全程无需人工打开 PowerPoint。【免费下载链接】OfficeCLIOfficeCLI 是首款也是最佳的专为 AI 代理设计的命令行工具可用于读取、编辑和自动化处理 Word、Excel 和 PowerPoint 文件。它免费、开源仅包含一个二进制文件无需安装 Office 套件。项目地址: https://gitcode.com/iOfficeAI/OfficeCLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 OfficeCLI 在 PPT 中嵌入视频：四张幻灯片的完整实战与 OOXML 底层原理
用 OfficeCLI 在 PPT 中嵌入视频四张幻灯片的完整实战与 OOXML 底层原理【免费下载链接】OfficeCLIOfficeCLI 是首款也是最佳的专为 AI 代理设计的命令行工具可用于读取、编辑和自动化处理 Word、Excel 和 PowerPoint 文件。它免费、开源仅包含一个二进制文件无需安装 Office 套件。项目地址: https://gitcode.com/iOfficeAI/OfficeCLIOfficeCLI 是专为 AI 代理设计的命令行工具可在不安装 Office 套件的情况下读取、编辑和自动化处理 Word、Excel 与 PowerPoint 文件。本篇技术指南以仓库中的 examples/ppt/video.md 为骨架完整讲解如何在 PowerPointPPTX中嵌入 MP4 视频、设置封面图poster、控制音量与自动播放、实现循环与裁剪播放并通过源码级分析揭示这些命令背后的 OOXML 实现原理。读完本文你将掌握officecli的--type video元素全参数用法、可复现的构建脚本以及从命令行、Python SDK 两种方式生成含视频演示文稿的完整方案。一、示例概览三个文件协同工作examples/ppt/video.md对应的完整示例由三个文件组成video.py—— Python 构建脚本。先用imageio现场合成一段 MP4 测试视频再通过officecli Python SDKpip install officecli-sdk构建一个嵌入视频的 4 页演示文稿每次officecli调用都会输出到 stdout。video.sh—— 与 video.py 等价的CLI 版脚本。两者生成完全等效的video.pptx。脚本故意不设置set -e与 SDK 版的doc.batch(...)一样容忍前向兼容的 UNSUPPORTED props 警告officecli 退出码 2继续构建完整文档。video.md—— 本文档将每张幻灯片映射到它演示的视频嵌入功能。从源码结构看SDK 版的doc.batch([...])中每个条目都是与officecli batch列表完全相同的{command, parent/path, type, props}字典因此两种方式在语义上是同一套命令面。二、环境准备与重新生成在examples/ppt目录下执行cd examples/ppt pip install imageio imageio-ffmpeg numpy python3 video.py # → video.pptx脚本会生成一段3 秒、640×360 的 MP4内容为动态渐变背景 移动圆球提取第一帧作为封面 PNG将两者嵌入 PPTX 后自动清理临时文件。若未安装imageio脚本会打印明确提示ERROR: imageio not installed. Run: pip install imageio imageio-ffmpeg numpyvideo.sh的用法为./video.sh [officecli path]可选参数用于指定 officecli 可执行文件路径默认使用 PATH 中的officecli。生成后脚本还会自动执行officecli validate $FILE做一次校验。三、Slide 1 —— 标题页径向渐变背景与占位符第 1 页演示了基于layouttitle版式的占位符型幻灯片配合radial径向渐变背景officecli add video.pptx / --type slide --prop layouttitle officecli set video.pptx /slide[1] --prop backgroundradial:1B2838-4472C4-bl officecli set video.pptx /slide[1]/placeholder[ctrTitle] \ --prop textVideo Demo --prop colorFFFFFF --prop size44 officecli set video.pptx /slide[1]/placeholder[subTitle] \ --prop textEmbedded video with officecli --prop colorB4C7E7 --prop size20涉及功能layouttitle占位符型幻灯片、backgroundradial:color1-color2-corner渐变背景、placeholder[ctrTitle]/[subTitle]占位符寻址、color文字颜色、size字号。其中渐变背景格式radial:1B2838-4472C4-bl表示径向渐变起始色#1B2838结束色#4472C4渐变方向/落点由末尾的blbottom-left指定。四、Slide 2 —— 嵌入视频自动播放与音量这是核心视频演示页。MP4 通过src嵌入 PPTX 包内用poster指定播放前显示的静态封面并开启自动播放officecli add video.pptx / --type slide --prop titleAnimated Video officecli set video.pptx /slide[2] --prop background0D1B2A officecli set video.pptx /slide[2]/shape[1] --prop colorFFFFFF officecli add video.pptx /slide[2] --type video \ --prop src/path/to/demo.mp4 \ --prop poster/path/to/cover.png \ --prop x2cm --prop y4cm --prop width22cm --prop height12.5cm \ --prop volume80 \ --prop autoplaytrue各属性语义属性类型说明src路径把 MP4 嵌入 PPTX 包内可传文件路径、URL 或>officecli add video.pptx / --type slide --prop titleVideo Properties officecli set video.pptx /slide[3] --prop background1B2838 officecli set video.pptx /slide[3]/shape[1] --prop colorFFFFFF # 信息框带 \n 换行的多行文本等宽字体 officecli add video.pptx /slide[3] --type shape \ --prop textResolution: 640x360\nFPS: 30\nDuration: 3s\nFormat: MP4 \ --prop fontConsolas --prop size16 --prop colorB4C7E7 \ --prop x1cm --prop y4cm --prop width10cm --prop height6cm \ --prop fill0D1B2A --prop line4472C4 --prop linewidth1pt # 柱状图帧颜色分析 officecli add video.pptx /slide[3] --type chart \ --prop chartTypebar \ --prop titleFrame Colors \ --prop categoriesRed,Green,Blue \ --prop series1Start:20,30,200 \ --prop series2End:80,30,80 \ --prop colorsE74C3C,27AE60 \ --prop x13cm --prop y4cm --prop width12cm --prop height8cm涉及功能--type shape多行文本\n换行、fontConsolas等宽字体、line/linewidth形状边框、fill形状填充以及--type chart的chartTypebar柱状图、series1名称:v1,v2,…系列数据、categories分类轴、colors系列颜色——这些能力可与视频元素共存于同一幻灯片。图表系列格式series1Start:20,30,200表示系列名 Start、三个数据点若完全不提供数据officecli会提示Chart requires data. Use: dataSeries1:1,2,3;Series2:4,5,6 or series1Revenue:100,200,300。六、Slide 4 —— loop / trimStart / trimEnd 播放控制第 4 页演示循环与裁剪的组合视频在源文件的子区间3 秒视频中仅播放 0–2 秒内无限循环officecli add video.pptx / --type slide --prop titleloop / trimStart / trimEnd officecli set video.pptx /slide[4] --prop background0D1B2A officecli set video.pptx /slide[4]/shape[1] --prop colorFFFFFF officecli add video.pptx /slide[4] --type video \ --prop src/path/to/demo.mp4 \ --prop poster/path/to/cover.png \ --prop x2cm --prop y4cm --prop width22cm --prop height12.5cm \ --prop volume60 \ --prop autoplaytrue \ --prop looptrue \ --prop trimStart0 \ --prop trimEnd2 # 说明文字标注 officecli add video.pptx /slide[4] --type shape \ --prop textlooptrue trimStart0 trimEnd2\nVideo loops continuously; playback is clipped to the 0–2s range. \ --prop size14 --prop colorB4C7E7 \ --prop x1cm --prop y17cm --prop width24cm --prop height2cm属性类型效果looptruebool视频播放到结尾后重新开始trimStartNnumber秒播放从第 N 秒开始trimEndNnumber秒播放到第 N 秒停止trimStart/trimEnd会被钳制到视频实际时长范围内二者与looptrue组合即可生成循环子片段。涉及功能loop布尔、trimStart秒、trimEnd秒、trim 与 loop 的组合。trim 参数的更丰富输入形式根据 schemas/help/pptx/media.json 中的模式定义trimStart/trimEnd实际上接受三种输入形式最终统一以毫秒整数写入文件读回时也是毫秒字符串--prop trimStart1500 # 纯毫秒 --prop trimStart1.5s # 秒带 s 后缀 --prop trimStart00:00:01.500 # hh:mm:ss.fff 时间戳对应的别名是trimstart/trimend。在 PowerPointHandler.Add.Media.cs 的NormalizeMediaTimeMs中可以看到归一化逻辑含冒号的走hh:mm:ss(.fff)解析带ms/s后缀的按比例换算最终统一转为毫秒整数。七、功能覆盖总表下表来自原文档汇总了每张幻灯片演示的功能FeatureSlidelayouttitle占位符型幻灯片1backgroundradial:渐变1background纯色 hex2, 3, 4placeholder[ctrTitle]/[subTitle]1--type video元素2, 4src嵌入 MP4 到包内2, 4poster封面图2, 4volume0–1002, 4autoplay2, 4loop4trimStart/trimEnd秒4x/y/width/heightcm2, 3, 4--type shape多行文本\n3, 4fontConsolas等宽标注3line / linewidth形状边框3--type chart视频页上的柱状图3series1名称:v1,v2、colors3八、检查生成的 PPTXquery / get 回读生成后可以用officecli的查询命令回读文档结构与视频节点officecli query video.pptx slide officecli get video.pptx /slide[2] officecli get video.pptx /slide[2]/video[1] officecli get video.pptx /slide[4]/video[1]其中/slide[N]/video[M]正是 media.json 中定义的定位路径格式positional: [/slide[N]/video[M], /slide[N]/audio[M]]。src与poster仅在 add/set 时接受get 不返回src键而位置、尺寸、音量、autoplay、loop、trim 等均支持 get 回读——例如x回读为 cm 长度字符串、volume回读为百分比、trimStart回读为毫秒字符串。九、源码级原理一个--type video到底做了什么从 PowerPointHandler.Add.Media.cs 的AddMedia方法可以还原视频嵌入的完整流程类型推断typevideo强制走视频分支typemedia时按扩展名路由——.mp4/.avi/.wmv/.mpg/.mov判为视频.mp3/.wav/.wma/.m4a判为音频图片扩展名.gif/.png/.jpg等则转发到AddPicture走图片路径。内容类型映射.mp4 → video/mp4、.avi → video/x-msvideo、.mov → video/quicktime等映射表见 Add.Media.cs。创建MediaDataPart并写入二进制流Add.Media.cs。建立两类关系视频走AddVideoReferenceRelationshipAddMediaReferenceRelationship双关系音频走AddAudioReferenceRelationship。视频的实际数据由p14:media扩展PowerPoint 2010的Embed属性引用。封面图处理提供poster时按图片解析并嵌入不提供时自动生成 1×1 透明 PNG 占位图源码中以字节数组形式内嵌这与 media.json 中 Poster image auto-generated when not supplied 的说明一致。位置与尺寸显式给定x/y/width/height时按 EMU 解析缺省时默认占幻灯片宽高的 75% 并水平垂直居中。负尺寸会被拒绝Negative width is not allowed。构造Picture结构cNvPr上挂hlinkClick actionppaction://media点击播放的钩子nvPr中放VideoFromFile/AudioFromFile再追加p14:media扩展BlipFill的r:embed指向封面图。trim 归一化trimStart/trimEnd经NormalizeMediaTimeMs归一为毫秒整数写入p14:trim/st|end。源码注释特别强调PowerPoint 拒绝打开st为时间戳字面量的文件报0x80070570 file corrupted因此 wire 格式必须是毫秒整数。播放行为timing 节点volume默认 80000即 80%0–100 输入直接乘 1000 得到 0–1000000–1 区间输入如 0.8会自动放大 100 倍归一。autoplay接受autoplay/autostart别名autoStart是 PowerPoint 界面用语autoplay是既有规范名仅true不区分大小写视为开启。looptrue在播放器节点的cTn上写repeatCountindefinite对应 PowerPoint 的 Loop until Stopped默认关闭。最终由AddMediaTimingNode将上述设置写入幻灯片的时序timing树并保存。对应的set 侧修改已有视频由 PowerPointHandler.Set.Media.cs 承担其属性面src替换、位置尺寸、裁剪、效果等与 add 保持一致。十、两种驱动方式CLI 脚本与 Python SDK 等价CLI 方式video.shofficecli create→officecli open→ 逐条officecli add/set→officecli close→officecli validate。SDK 方式video.pyofficecli.create(FILE, --force)启动一个常驻resident进程通过命名管道以doc.batch([...])一次往返提交全部命令doc.send({command: get, ...})回读校验最后doc.send({command: save})落盘上下文退出时自动刷新。SDK 导入优先尝试已安装的officecli-sdk失败则回退到仓库内 sdk/python 目录的副本。两者生成完全等效的video.pptx你可以根据自动化场景任选其一。结语通过本文你已经掌握了 OfficeCLI 嵌入视频的完整命令面src/poster/volume/autoplay/loop/trimStart/trimEnd 定位尺寸、两种自动化驱动方式以及 OOXML 层面的实现细节p14:media扩展、ppaction://media点击钩子、repeatCountindefinite循环、trim 毫秒归一化等。在 AI 代理场景中你可以直接用officecli add ... --type video让代理为报告、产品演示或培训课件插入带封面、自动播放、循环子片段的视频全程无需人工打开 PowerPoint。【免费下载链接】OfficeCLIOfficeCLI 是首款也是最佳的专为 AI 代理设计的命令行工具可用于读取、编辑和自动化处理 Word、Excel 和 PowerPoint 文件。它免费、开源仅包含一个二进制文件无需安装 Office 套件。项目地址: https://gitcode.com/iOfficeAI/OfficeCLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考