安装和更新

安装顺序

这里有的两个版本的Blend4Web框架:Blend4Web SDK和Blend4Web插件。为了确定哪一种最适合你的需求,你需要决定哪种你正在计划开发应用程序。

如果你打算使用Blend4Web引擎所提供的所有功能,您应该安装Blend4Web SDK。

如果你的目的是要开发小规模的项目,或者如果您打算只使用的Blend4Web引擎的功能的数量有限(例如法线编辑器),你可能会考虑安装 Blend4Web 插件 来代替。

注意:插件只能导出场景到 HTML格式 和有限功能 (例如,它没有 项目管理,示例场景,用户手册,其他额外资源等等),但它仍然拥有一切让你可以创建一个简单的应用程序。

安装Blender

直接在 Blender 中创作 3D 场景,这是开放源码软件和免费分发软件。

安装之前,请下载并安装兼容的Blender版本,根据此 .

应使用当前的稳定版本的Blender。它可以从 官方网站 或从 Blend4Web 网站 下载 。

_images/blender_first_run.png

安装Blend4Web SDK

稳定版作为压缩包发布 (blend4web_sdk_free_YY_MM.zip – 免费 SDK, blend4web_sdk_pro_YY_MM.zip – 商业 SDK). 只要在某处解开这个压缩包。

  1. 打开Blender。

  2. 打开用户首选项面板 File > User Preferences....

  3. 打开 File 选项卡。

  4. Scripts 中设置 SDK 目录的路径。

  5. 单击 Save User Settings 按钮。

    _images/user_preferences_sdk_path.png
  6. 重新启动Blender。

  7. 打开用户首选项面板 File > User Preferences....

  8. 打开 File 选项卡。

  9. 启用 Blend4Web 插件。

  10. 单击 Save User Settings 按钮。

    _images/user_preferences_enable_addon.png

验证是否工作:

File > Export 菜单 Blend4Web (.json)Blend4Web (.html) 选项应该出现。

安装Blend4Web 插件

_images/user_preferences_install_from_file.png

它可以和其他 Blender插件 的安装方式相同。

  1. 打开Blender。

  2. 打开用户首选项面板 File > User Preferences....

  3. 打开 File 选项卡。

  4. 从文件安装... 按钮。

  5. 选择包含Blend4Web插件的文件,然后按 从文件安装... 按钮。

  6. 单击 Save User Settings 按钮。

  7. 重新启动Blender。

  8. 打开用户首选项面板 File > User Preferences....

  9. 打开 File 选项卡。

  10. 在列表中找到 Blend4Web 插件。

  11. 勾选标题左侧的框以启用它.。

  12. 再按一次点击 Save User Settings 按钮。

现在,一切都应该能正常工作了。


切换到Blend4Web模式

为了查看该引擎设置,从顶部面板菜单中选择Blend4Web:

_images/first_steps_selecting_engine.png

更新

更新 SDK

在更新之前,我们建议您使用 project export 工具备份的所有开发中的项目.

要更新SDK,请按照下列步骤操作:

  1. 下载SDK的新版本。

  2. 打开Blender。

  3. 打开 用户设置 窗口。

  4. 打开 Add-ons 面板。

  5. 禁用 Blend4Web 插件。

    注解

    我们建议不要使用 Remove 按钮禁用插件来更新SDK,因为这样做会彻底删除插件,包括它的SDK文件。

  6. 解压新版本SDK。

    注解

    有两种方法来更新 SDK。

    首先,可以完全删除 SDK 文件夹中,在那之后,提取新版本文件夹并将路径设置为它在Blender设置,就像你第一次安装 SDK一样。

    第二,你可以简单地使用新的覆盖过时的 SDK 文件。此方法被认为是不太 “纯净”,但在大多数情况下,它不应导致任何问题。

  7. 用户设置 窗口中打开 File 面板。

  8. 设置 Scripts 表格的路径SDK文件夹。

  9. 单击 Save User Settings 按钮。

  10. 重新启动Blender。

  11. 再次打开 用户设置 窗口。

  12. 打开 Add-ons 面板。

  13. 启用 Blend4Web 插件。

  14. 再按一次点击 Save User Settings 按钮。

  15. 检查一切正常。

完成更新后,您可以使用 项目导入 工具导入所有已保存的项目。

更新插件

如果你只使用Blend4Web插件,按照下面使用说明来做。

安装新版本的插件之前,您可以先删除现有之一。要做到这一点,展开Blend4Web插件的信息选项卡,然后按 Remove 按钮。删除旧版本安装新的不是必需的,但这样做可以确保不会有任何版本冲突。

_images/user_preferences_remove_addon.png
  1. 下载包含新版本插件的文件,并将其保存到硬盘上的任何地方。

  2. 打开Blender。

  3. 打开 用户设置 窗口。

  4. 切换到 Add-ons 面板。

  5. 从你下载的存档安装新版本的插件。

  6. 单击 Save User Settings 按钮。

  7. 重新启动Blender。

一切都应该能正常工作了。

更新保存的项目

你更新你的 SDK (或插件) 后,您可以导入之前导出的项目更新回项目管理器。要执行此操作,请按照以下说明︰

  1. 打开项目管理器

  2. 导入您的项目使用 Import Project(s) 按钮。

  3. 使用 re-export scenes 链接重新导出项目的 .blend 文件。

  4. 对每个导入的项目使用 check modules 链接来确保在程序代码中有没有缺少或未使用的模块。如果有,你可以试着使用 Update Modules 按钮来修复。

  5. 然后使用 build 命令, 生成版本使导入的项目再次工作。

  6. 开发者版本的项目使用 CopyCompile 引擎绑定类型也可以构建出与新版本的 SDK一起正常工作 (与其他绑定类型的项目的开发版本没有它也可以工作)。