它是什么
ASCIIplayer-embed.html 是
ASCII 视频工坊（完整版）的精简版播放器：
单文件、零构建（仅 CDN 引入 typegpu）、无参数面板——只做一件事，
读取 .ascii-video 文件并播放。帧数据由 WebGPU 着色器按当前参数
实时重算为字符画，因此字形大小、伽马、反色等参数可在加载后随时修改、即时生效。
所有画面参数通过 URL 查询字符串 或 postMessage 外部指定，
适合以 <iframe> 方式嵌入任意网页。
实时演示
下方 iframe 内嵌 Embed 播放器（示例数据 /ToolBase/ASCII/video/demo.ascii-video）。
右侧面板的所有改动通过 postMessage 实时推送，无需刷新；三个代码块与当前预览参数严格同步。
<iframe
src="/ToolBase/ASCII/ASCIIplayer-embed.html?src=/ToolBase/ASCII/video/demo.ascii-video"
width="960" height="540"
allow="autoplay"
style="border:0;border-radius:8px;background:#060b14"
title="ASCII 视频播放器">
</iframe>const player = document.querySelector('iframe');
// 实时改参: 与当前预览参数严格一致 (无需刷新)
player.contentWindow.postMessage({
type: 'ascii:params',
params: {},
}, '*');
// 播放控制
player.contentWindow.postMessage({ type: 'ascii:play' }, '*');
player.contentWindow.postMessage({ type: 'ascii:pause' }, '*');
player.contentWindow.postMessage({ type: 'ascii:seek', ratio: 0.5 }, '*');/ToolBase/ASCII/ASCIIplayer-embed.html?src=/ToolBase/ASCII/video/demo.ascii-video此 URL 与右侧预览参数严格一致：调整右侧任意参数后自动更新。
播放控制 (postMessage)
渲染参数 (postMessage 实时)
画面比例与播放
URL 示例（加载即生效）
每个示例都是独立的播放器实例，点击后在新标签页打开体验。
播放器诊断
加载中…
无法播放时复制诊断信息反馈，可快速定位问题。
嵌入方式
三种控制方式可混用：URL 参数加载时生效 → postMessage 随时覆盖 → 后到者胜。
ui=none 隐藏全部控件（纯画布，点击切换播放/暂停）；默认 ui=full 显示播放控制条。
完整参数表与 API 细节见「ASCII 视频工坊使用指南」（/guide-ascii/）。
URL 参数示例
每个示例都是独立的播放器实例：点击后在新标签页打开，URL 参数加载时即生效。
播放器诊断
播放器暴露 window.AsciiEmbed.getState()：返回帧数、尺寸、fps、播放状态、
渲染后端（webgpu/cpu）、错误计数等，可用于自动化验证与问题定位。
无法播放时，右侧面板「复制诊断」可一键收集环境信息。
三步上手
- 准备文件：先用完整版 ASCII 工坊 上传视频 → 调整参数 → 保存为
.ascii-video（v6/v7），或直接使用本站示例文件/ToolBase/ASCII/video/demo.ascii-video。 - 拼接 URL：把文件地址放进
?src=，追加需要的画面参数，例如?src=/demo.ascii-video&mode=grayscale&glyph=24。 - 嵌入页面：把上方「① 完整 iframe 引用」代码块粘贴进你的 HTML；如需动态调参，再加「② postMessage 外部控制」脚本。
allow="autoplay"，否则浏览器可能拦截。