扫一扫咨询方案
首页
登录/注册

{user.username}

ID: {user.id}

模板 SDK 文档

  • 云渲染

    • Demo下载
    • SDK
    • 开发指南
    • AI API 文档
    • 开发者 API 文档
    • 控制台指南
    • 快速入门
    • 产品简介
  • 模板SDK

    • 用户常见问题
    • Demo 下载
    • 开发指南
    • 服务端 SDK
    • iOS SDK
    • 安卓端 SDK
    • 产品简介
  • 剪辑SDK

    • Demo下载
    • SDK
    • 开发指南
    • 产品简介
  • 模板制作教程

    • 模板制作进阶教程
    • 测试模板素材案例下载
    • 常见模板制作案例
    • 模板制作教程
    • 模板制作工具下载
    • 入门指南
  • 剪辑制作教程

    • 剪辑特效导出教程
    • 剪辑特效测试素材
    • 剪辑特效制作工具下载
    • 入门指南
产品简介
安卓端 SDK
iOS SDK
服务端 SDK
开发指南
Demo 下载
用户常见问题
首页 > Android SDK > 预览模板

预览模板

更新时间 : 2021-02-22 09:35:56

预览流程

  1. 在界面布局中添加SXPlayerSurfaceView用于显示模板预览画面
  2. 调用SXTemplate类的构造函数,并传入模板路径和TemplateUsage.kForPreview作为参数构建一个SXTemplate实例对象
  3. 调用SXTemplate对象的setReplaceableFilePaths方法传入用户自定义素材
  4. (可选) 如果需要对模板进行进一步精细控制,先调用commit创建渲染对象,然后利用UI Key等自定义逻辑对模板渲染对象进行精细修改调节
  5. 调用SXPlayerSurfaceView类的setTemplate方法,并传入SXTemplate对象创建和绑定SXTemplatePlayer对象
  6. 获取到SXTemplatePlayer对象后即可调用其replaceAudio方法来设置音频路径

    默认使用模板根目录下music.mp3或music.aac

  7. 调用SXTemplatePlayer对象setPlayCallback方法来播放状态监听对象
  8. 调用SXTemplatePlayer对象startseekpausestop等方法对播放状态进行控制

代码示例

String folder = ;//模板根目录
String[] paths = ;//压缩后的图片路径数组
SXTemplate template = new SXTemplate(folder, SXTemplate.TemplateUsage.kForPreview);
template.setReplaceableFilePaths(paths);
template.commit();

SXPlayerSurfaceView playerView = findViewById(R.id.player_surface_view);
playerView.setPlayCallback(new SXTemplatePlayer.PlayStateListener() {
     @Override
     public void onProgressChanged(int frame) {
         //进度回调 frame为第几帧
     }

     @Override
     public void onFinish() {
         //播放完毕
     }
});

playerView.setTemplate(template);
SXTemplatePlayer player = playerView.getPlayer();
player.start();

注意事项

  1. 暂停只需调用pause,在activity的onDestory中调用stop
  2. 选择图片后需要进行压缩,否则预览时解码图片耗时较长会导致预览卡顿
  3. 每次setTemplate会返回新的player对象,SXPlayerSurfaceView#setPlayCallback之后调用setTemplate得到的Player对象会自动添加回调,SXTemplate#setPlayCallback只对当前player对象有效
首页 > Android SDK > 预览模板
预览模板
更新时间 : 2021-02-22 09:35:56
  • 云渲染
    • Demo下载
    • SDK
    • 开发指南
    • AI API 文档
    • 开发者 API 文档
    • 控制台指南
    • 快速入门
    • 产品简介
  • 模板SDK
    • 用户常见问题
    • Demo 下载
    • 开发指南
    • 服务端 SDK
    • iOS SDK
    • 安卓端 SDK
    • 产品简介
  • 剪辑SDK
    • Demo下载
    • SDK
    • 开发指南
    • 产品简介
  • 模板制作教程
    • 模板制作进阶教程
    • 测试模板素材案例下载
    • 常见模板制作案例
    • 模板制作教程
    • 模板制作工具下载
    • 入门指南
  • 剪辑制作教程
    • 剪辑特效导出教程
    • 剪辑特效测试素材
    • 剪辑特效制作工具下载
    • 入门指南

预览流程

  1. 在界面布局中添加SXPlayerSurfaceView用于显示模板预览画面
  2. 调用SXTemplate类的构造函数,并传入模板路径和TemplateUsage.kForPreview作为参数构建一个SXTemplate实例对象
  3. 调用SXTemplate对象的setReplaceableFilePaths方法传入用户自定义素材
  4. (可选) 如果需要对模板进行进一步精细控制,先调用commit创建渲染对象,然后利用UI Key等自定义逻辑对模板渲染对象进行精细修改调节
  5. 调用SXPlayerSurfaceView类的setTemplate方法,并传入SXTemplate对象创建和绑定SXTemplatePlayer对象
  6. 获取到SXTemplatePlayer对象后即可调用其replaceAudio方法来设置音频路径

    默认使用模板根目录下music.mp3或music.aac

  7. 调用SXTemplatePlayer对象setPlayCallback方法来播放状态监听对象
  8. 调用SXTemplatePlayer对象startseekpausestop等方法对播放状态进行控制

代码示例

String folder = ;//模板根目录
String[] paths = ;//压缩后的图片路径数组
SXTemplate template = new SXTemplate(folder, SXTemplate.TemplateUsage.kForPreview);
template.setReplaceableFilePaths(paths);
template.commit();

SXPlayerSurfaceView playerView = findViewById(R.id.player_surface_view);
playerView.setPlayCallback(new SXTemplatePlayer.PlayStateListener() {
     @Override
     public void onProgressChanged(int frame) {
         //进度回调 frame为第几帧
     }

     @Override
     public void onFinish() {
         //播放完毕
     }
});

playerView.setTemplate(template);
SXTemplatePlayer player = playerView.getPlayer();
player.start();

注意事项

  1. 暂停只需调用pause,在activity的onDestory中调用stop
  2. 选择图片后需要进行压缩,否则预览时解码图片耗时较长会导致预览卡顿
  3. 每次setTemplate会返回新的player对象,SXPlayerSurfaceView#setPlayCallback之后调用setTemplate得到的Player对象会自动添加回调,SXTemplate#setPlayCallback只对当前player对象有效