1. 脚本添加方式
- 全局脚本:在整个动画中都有效。
// 全局脚本示例 window.abc = 1;
- 页脚本:仅在特定页面有效,可使用
pageIndex
获取页号。// 页脚本示例 alert(pageIndex); // 弹出页号,例如 0
2. Mugeda API 结构
- mugeda 对象:获取动画的基本信息和控制。
var mugeda = window['Mugeda']['currentAni']; console.log(mugeda.title); // 获取动画标题
- scene 对象:控制动画的时间轴和播放。
var scene = mugeda.scene; scene.gotoAndPlay(10); // 跳转到第10帧并播放
- aObject 对象:控制动画元素的属性。
var aObject = scene.getObjectByName("myObject"); aObject.x = 100; // 设置元素的x坐标
3. 动画嵌入网页
- iframe 方式:
<iframe src="animation_url" frameborder="0"></iframe>
- 直接嵌入:
<div id="animationContainer"></div> <script src="loader.js"></script> <script> window._mrmcp = { "creative_path": "animation_folder/", "script_id": "scriptElement", "render_mode": "embedded" }; </script>
4. 事件监听
- mugeda 事件:监听动画的不同阶段。
mugeda.addEventListener("renderready", function(){ // 动画渲染准备完成 });
- scene 事件:监听每一帧的渲染。
scene.addEventListener("enterframe", function(){ console.log(scene.currentId); // 当前帧号 });
5. 对象属性和方法
- mugeda 属性:获取动画的全局信息。
console.log(mugeda.width, mugeda.height); // 获取舞台大小
- scene 方法:控制播放进程和时间轴信息。
scene.nextPage(); // 跳转到下一页
- aObject 属性:控制动画元素的具体表现。
aObject.visible = false; // 隐藏元素
6. 调试
- IDE 预览调试:在 IDE 中预览动画时调试。
console.log("Debug message"); // 调试信息
- 浏览器调试:导出动画后在浏览器中调试。
// 浏览器控制台 debugger; // 断点调试
7. 工具 API
- 微信转发:自定义微信转发信息。
defineWechatParameters({ title: "Share Title", desc: "Share Description", img_url: "Image URL" });
- 信息提示:显示信息提示。
Mugine.Utils.Toast.info('提示信息');
8. 自定义昵称/头像
- 自定义昵称:通过回调函数自定义昵称显示。
window.mugeda_nickname_callback = function(wxNickName) { return wxNickName.substring(0, 6); };
- 自定义头像:自定义头像显示。
window.mugeda_avatar_callback = function() { return 'custom_avatar_url'; };
9. 客户端内打开检测
- 检测是否在微信内打开:
if (navigator.userAgent.indexOf('MicroMessenger') > -1) { alert("请在微信中打开"); }
10. aObject 事件绑定
- 绑定点击事件:
aObject.addEventListener("click", function(e){ e.stopPropagation(); // 阻止事件冒泡 });
11. aObject 的 DOM 操作
- 获取 DOM 并操作:
var dom = aObject.dom; dom.style.backgroundColor = 'red'; // 改变背景颜色
12. 动画生命周期和可见性
- 生命周期控制:
// 假设物体的生命周期在时间轴上从第5帧到第15帧
- visible 属性:控制物体的可见性。
aObject.visible = true; // 使物体可见
- getRealVisible:获取物体的真实可见性。 复制
var reallyVisible = aObject.getRealVisible; // 获取最终可见性