本文档通过一个实例介绍可定制贺卡的动画的制作过程。实例包含两部分:

  1. 动画部分:介绍动画制作过程中如何给祝福词和落款的文本对象命名,如何给定制按钮定义表单动作。

  2. 代码部分:介绍贺卡的脚本逻辑的编写。

 

  例程编辑地址:

  https://cn.mugeda.com/animation/edit/0326f6a1

  例程预览地址:

  https://cn.mugeda.com/client/preview_css3.html?id=0326f6a1



动画部分

  动画需要注意修改的地方:

  1. 给祝福词和落款等文本对象命名;

  2. 给定制按钮定义表单动作。

给祝福词和落款等文本对象命名

  下面的例子说明了祝福词和落款的命名过程:

  给祝福词命名:选中祝福词所在的组,双击进入组中,选中祝福词文本对象,在属性栏中给该文本对象命名为“greetings”。


html5生日贺卡网页代码 用html制作贺卡_表单

  给落款命名:同样选中落款文字所在的组,双击进入组中,选中落款文本对象,在属性栏中给它命名为“from”。

  用同样的方式,可以为更多的对象进行命名。


html5生日贺卡网页代码 用html制作贺卡_取值_02

给定制按钮定义表单动作

  选中定制按钮,在属性栏中的动作中选择“表单”,然后点编辑。



html5生日贺卡网页代码 用html制作贺卡_表单_03

  在弹出的编辑表单对话框中依次做如下操作:输入表单名称;选择提交方式为”回调函数”回调函数名称为”createCustomParameters“;确认消息是定制成功后弹出对话框中显示的信息,可以根据需要编写;表单项\添加表单项,来添加表单的表单项。



html5生日贺卡网页代码 用html制作贺卡_回调函数_04


  编辑祝福词表单项:添加表单项后弹出的编辑表单项对话框中,依次做如下操作:名称输入greetings;描述:编辑祝福词;类型选择文本域;取值是祝福词的默认值,可以根据需要填写。完成上面操作后点击保存。



html5生日贺卡网页代码 用html制作贺卡_回调函数_05

  编辑落款人表单项:编辑完祝福词表单项后,再次点击添加表单项,来添加落款人表单项。在弹出的对话框中,依次做:名称输入”from“;描述:”发送人落款“;类型选输入框;取值是落款人的默认值,可以根据需要填写。完成后点击保存。


html5生日贺卡网页代码 用html制作贺卡_取值_06

  用同样的方法可以输入更多的表单项目。

  表单编辑完成后,点击确认。这样动画中所有的修改都做完了,保存动画。

代码部分

引入外部库文件

  我们将贺卡的常用操作封装成了库文件card_common.js,使用这个库文件,简化代码的编写。

  首先需要将公共代码库的引入我们的IDE:点击“文件”、“导入”、“脚本”,引入公共脚本:


html5生日贺卡网页代码 用html制作贺卡_回调函数_07



html5生日贺卡网页代码 用html制作贺卡_回调函数_08

点击“增加”,然后输入https://www.mugeda.com/third_party/general-usage/js/card_common_mini.js,确定。

编写用户代码

  点击工具栏上的脚本按钮,输入用户代码。请参考例程中的代码,以此为基础,修改用应用于自己的贺卡中。

绑定表单和动画元素

绑定表单的意思是,保持表单的内容和动画中的某些元素的内容始终保持一样。如下面例子,defineCustomParameters函数绑定了表单和动画元素。它接受一个mugeda.scene对象和一个数组。

defineCustomParameters(mugeda.scene, [
     { formName: 'to', formDescription: '收信人', mugedaObj: [{ name: 'to', attribute: 'text' }] },
     { formName: 'greetings', formDescription: '编辑祝福词', mugedaObj: [{ name: 'greetings', attribute: 'text' }] },
     { formName: 'from', formDescription: '发送人落款', mugedaObj: [{ name: 'from', attribute: 'text' }, { Name: 'from2', attribute: 'text' }] },
     { formName: 'url', formDescription: '发送人网站', mugedaObj: [{ name: '', attribute: 'data' }] }
]);

数组的意思是这样的,它formName和formDescrition对应于表单中的‘名称’和‘描述’字段,mugedaObj是一个数组,对应于主舞台上的对象。name指的是这个对象的名字,attribute指的是这个对象的属性(如上面的name: 'to', attribute: 'text'指的是mugeda.scene.getObjectByName('to').text)。这样就将一个动画元素和表单元素绑定在了一起,它们的值会保持一样的。

不过这样有一个问题是,如果要引用元件实例中的一个物体,怎么办。可以用”/”分隔层级,例如name: ‘obj1/obj2’指的是名字为obj1元件的实例中的名字为obj2的元素。

attribute = data是一个特殊的值,它不绑定任何动画元素,例如上面的例子中的最后一行,效果是,表单中的url字段,被绑定到了全局变量data.url.value,可以在脚本中直接设值或者取值。

定义微信转发和共享所需要的参数

defineWechatParameters({
     "img_url": "https://mugeda-mobile.mugeda.com/weixin/logo_128.png",
     "img_width": 128,
     "img_height": 128,
     "desc": "木疙瘩自己定义的描述",
     "title": "木疙瘩自己定义的标题"
});

就像上面那样,img_url、img_width、img_height,定义了缩略图的地址、长、宽,desc和title是描述和标题。

定义表单提交后的行为

通常,用户提交表单后,会调用用户自定义的回调函数,用户可以在回调函数中做一些想要的操作。在完成用户自定操作后,调用finalizeCustomParameters(data)方法,card_common.js将完成贺卡定制的后续操作。

例如:
window.createCustomParameters = function (data) {
    finalizeCustomParameters(data);
}
使用
通过网页中的script标签,或者IDE中的载入外部脚本功能,引入https://www.mugeda.com/third_party/general-usage/js/card_common_mini.js
例子
action脚本的例子:
Mugeda.script.push(function (mugeda) {
    var mugeda = Mugeda.getMugedaObject();
    mugeda.addEventListener("renderReady", function () {
        defineCustomParameters(mugeda.scene, [
            { formName: 'to', formDescription: '收信人', mugedaObj: [{ name: 'to', attribute: 'text' }] },
            { formName: 'greetings', formDescription: '编辑祝福词', mugedaObj: [{ name: 'greetings', attribute: 'text' }] },
            { formName: 'from', formDescription: '发送人落款', mugedaObj: [{ name: 'from', attribute: 'text' }, { name: 'from2', attribute: 'text' }] },
            { formName: 'url', formDescription: '发送人网站', mugedaObj: [{ name: '', attribute: 'data' }] }
        ]);
        defineWechatParameters({
             "img_url": "https://mugeda-mobile.mugeda.com/weixin/logo_128.png",
             "img_width": 128,
             "img_height": 128,
             "desc": "木疙瘩自己定义的描述",
             "title": "木疙瘩自己定义的标题"
        });
        // 加载音频
        var audio = loadAudio('52e374dbe8ad7e2968000099.mp3');
        // 点击屏幕后,播放音频
        window.light = function () {
            try{
                audio.play(1);
                }catch(e){
                    audio.play(0);
                }
        };
        window.directLinks = function () {
            window.open(data['url'].value, '_blank');
        };
        window.createCustomParameters = function (data) {
            finalizeCustomParameters(data);
        };
    });
});