SuperAPI AI 工具集

android-walkthrough-video

测试与质量

查看项目

更新于 10-16 03:14

技能介绍

用途:把实际操作 Android 应用的过程录成带说明卡片的演示视频(MP4 或 GIF),适合做引导、演示或 README 素材。它本身不驱动应用,操作由 android-ui-driver 完成,本技能负责录屏、打点与合成。

主要能力:walkthrough.py 提供 start、mark、stop、render 四个阶段,另有 --self-test 离线卡片渲染检查。start 启用 show_touches 让点击可见;mark 在当前时刻盖上说明卡片,支持 --kicker、--body、--duration,--style hero 做开场/结尾标题卡,--pos top|center|bottom 调整位置;stop 停止录制、拉取 MP4 并按记录时间戳合成;render 可只用 session.json 重新渲染,不必重录。默认渲染会压缩无卡片的停顿(约 4x),整片通常缩短 25–30%。输出 H.264/CRF 20、yuv420p、faststart 的 MP4,--gif 产出 480px、12fps 双通道调色 GIF,--srt 可另存字幕轨。

依赖与用法:需要 adb,渲染阶段需要 ffmpeg 与 Pillow(pip install pillow)。卡片先画成 PNG,再用 ffmpeg overlay 合成,刻意不用 drawtext(很多 brew 安装的 ffmpeg 缺少 freetype)。命令示例:python3 "${CLAUDE_SKILL_DIR}/scripts/walkthrough.py" --out DIR <cmd>;start 时可用 --theme glass(默认)或 coral/indigo/paper;mark 用法:walkthrough.py --out ./demo mark "Browse by category" --kicker "Step 2" --body "..." --duration 4;渲染:walkthrough.py --out ./demo stop --name app-tour --gif。

限制与注意事项:screenrecord 为可变帧率,静止画面几乎没有帧,卡片可能不显示,渲染前会先归一化为 CFR(--fps 默认 30)。--text 驱动每次操作会增加约 2 秒空档,建议彩排时用 snap 取坐标再以 tap --at X,Y 驱动,并优先用裁剪而非整体 --speed(会扭曲触摸动画)。录制中旋转设备会终止录制;FLAG_SECURE 界面录成黑色,无纯 adb 解法;录制会包含通知与个人数据,建议用一次性模拟器,脚本也拒绝自动选择物理设备;无音频,需在剪辑器中补解说。建议游览时长 30–90 秒;stop 找不到文件通常是尺寸不支持,可尝试 start --size 720x1600。