腾讯礼物动画特效提供了适用于不同开发平台的 Demo。本文将主要介绍如何快速跑通礼物动画特效 SDK 的 Android 端 Demo。
下载
环境要求
Android Studio 2.0 或以上版本。
Android SDK API Level 19 及以上。
Android 4.4 及以上,支持 armeabi-v7a、arm-v8a 架构的移动设备。
导入项目
首先打开 Android Studio,选择 Open an Existing Project,然后找到前面的下载解压的 Demo 项目目录,选择 TCEffectPlayerDemo,单击 Open,完成项目的导入工作。

修改依赖和配置
等待 AndroidStudio 导入项目完成之后,需要对 Demo 项目进行一些修改,来保证项目后续的正常运行:
1. 找到 app/libs 目录,删除旧的示例 SDK AAR 文件,替换为最新的腾讯动画特效播放器 SDK AAR 文件:

2. 替换项目中的的 license 信息,将值替换为您申请到的腾讯动画特效播放器 SDK license 信息:

3. 修改项目的应用 id,即替换下图中的 applicationId 值,替换为您申请到的腾讯动画特效播放器 SDK license 所对应的 Android 包名:

4. 以上修改操作完毕之后,建议点击 Build/Clean Project 清理掉之前项目中旧 AAR 的缓存文件。
动画资源配置
说明:
如果您不需要播放自己的动画文件,则可以跳过当前步骤。
需要修改要播放的动画文件,可以在 app/main/assets 中来添加要播放体验的动画文件,然后打开 MainActivity.java 文件,修改顶部的 FILE_NAME_TEP (大动画)或者 FILE_NAME_TEPGS(小头像动画) 属性,Demo 中会自动完成动画文件的复制等工作,后续可以直接运行 Demo 项目来体验动画播放。

注意:
Demo 中自带的动画文件没有绑定 License,因此您可以使用自己的 License 来播放体验。
如果要替换自己的动画,需要注意动画的 License 信息要跟项目内设置的 License 信息一致,否则因为 License 信息不匹配而播放失败。
编译运行
1. 确保测试设备与 Android Studio 已经正常连接。

2. 点击运行即可将测试 Demo 运行到真机进行体验。
3. Demo 项目运行到真机后,效果如下图:

此时,控制台首先会打印:
TCMediaX license result: errCode: 0, msg: Success
此日志信息表示此时 SDK license 鉴权已经成功。
接下来可以点击底部的 MP4 或者 TCMP4 按钮开始播放体验动画。
注意:
腾讯礼物动画特效 SDK 首次鉴权 license 时需要依赖网络,因此在运行 Demo 启动时,需要联网。