swf2js快速开始指南：一行代码让你的网站重新播放Flash动画
项目地址: https://gitcode.com/gh_mirrors/sw/swf2js Flash 已经退出历史舞台，但那些经典的 SWF 动画和游戏并没有失去价值。swf2js 是一款纯 JavaScript 编写的 Flash Player 运行时引擎，能够在现代浏览器中重新播放 Flash 动画。它无需安装任何插件，实时解析 SWF 文件并渲染为 HTML 页面元素，兼容 Flex、Flash、Animate 以及所有平台的 SWF 文件。本文将带你用最短的时间上手 swf2js，让老动画在你的网站上"复活"。
为什么你需要 swf2js？🎬
2020 年底 Adobe 正式停止 Flash Player 的维护，浏览器全面禁用 Flash 插件，大量依赖 SWF 的课件、小游戏、广告素材一夜之间无法打开。swf2js 的出现解决了这个痛点：
- 零插件依赖：基于 HTML5 Canvas 渲染，任何现代浏览器都能直接播放
- 纯 JavaScript 实现：引擎完全由 JS 编写，可轻松嵌入任意网页
- 兼容 ActionScript：免费版支持 AS 1.0/2.0，生产版支持 AS 3.0
- 支持多种压缩：免费版支持 ZLIB 压缩，生产版额外支持 LZMA
- 开箱即用：引入一个文件即可，无需复杂配置
快速开始：一行代码播放 Flash 动画 ⚡
swf2js 的使用极其简单，只需两步。第一步，在页面中引入引擎文件 swf2js.js：
<script type="text/javascript" src="swf2js.js"></script>
第二步，调用 load 方法传入 SWF 文件地址，全部过程只需要这一行核心代码：
swf2js.load('你的动画.swf');
这就是 README 中官方给出的 HTML 示例代码，把 swf2js.js 和你的 SWF 文件放在服务器上，打开页面即可看到动画正常播放。引擎会自动创建画布、解析 SWF 二进制数据并逐帧渲染，你甚至不需要编写任何额外样式。
进阶玩法：自定义播放参数 🎛️
swf2js.load 方法还支持传入配置对象，load 的实现源码 中可以看到完整的参数支持：
- optionWidth / optionHeight：强制指定播放画布尺寸
- callback：加载完成后的回调函数
- tagId：指定画布挂载的容器节点 ID
- renderMode：渲染模式
- FlashVars：传递 Flash 变量，兼容老动画的外部参数
- quality：渲染质量
- bgcolor：背景色
例如同时加载多个动画时，可以用 tagId 把每个动画分别挂载到不同的 div 容器中，互不干扰。
不想改代码？用用户脚本一键播放 📌
如果你只是想浏览历史网页中的 Flash 内容，而不想修改任何代码，项目还提供了现成的用户脚本 swf2js.user.js。配合 Tampermonkey 等浏览器扩展安装后，脚本会自动检测网页中的 embed 标签，并在 SWF 文件位置显示一个"Play"按钮，点击即可直接播放，非常方便。
常见问题解答 💡
Q：swf2js 支持哪些浏览器？ A：只要支持 HTML5 Canvas 的浏览器都可以，包括 Chrome、Firefox、Edge、Safari 以及移动端浏览器。
Q：动画中的按钮和交互能正常工作吗？ A：可以。引擎实现了完整的点击、悬停、拖拽等交互事件，并支持 DropShadow、Blur、Glow、Bevel 等常见滤镜效果。
Q：免费版和生产版有什么区别？ A：免费版支持 ActionScript 1.0/2.0 与 ZLIB 压缩；生产版支持 AS 3.0、LZMA 压缩、完整 WebGL 渲染、全部滤镜与混合模式，以及 MP4/FLV 视频播放。
Q：如何获取源码？ A：可以通过 git clone https://gitcode.com/gh_mirrors/sw/swf2js 获取完整项目。
项目现状与未来 🚀
swf2js 作为 Flash 模拟器已经功能完整，目前项目正逐步进化到 Next2D 计划：从"播放旧动画"转向"创作新内容"，将 Flash 开发流程迁移到现代 Web 技术栈。无论是怀旧播放经典 SWF，还是研究 Flash 文件格式解析，swf2js 都是一个值得收藏的开源宝藏。现在就去获取代码，让你的网站重新响起 Flash 动画的旋律吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
