找回密码
 注册帐号

扫一扫,访问微社区

使用网络播放器模版

2015-1-8 18:32| 发布者: 杨炎| 查看: 1745| 评论: 0|原作者: 蛮牛|来自: unity3d脚本manual

摘要: 使用网络播放器模版构建网络播放器工程时,unity 将播放器嵌入到 html 页面中,以便可以在浏览器中播放。默认页面非常简单,只有白色背景和部分最小文本。事实上,该页面有三种不同形式,可从播放器设置 (player set ...

使用网络播放器模版

构建网络播放器工程时,unity 将播放器嵌入到 html 页面中,以便可以在浏览器中播放。默认页面非常简单,只有白色背景和部分最小文本。事实上,该页面有三种不同形式,可从播放器设置 (player settings) 检视器(菜单:编辑 (edit) > 工程设置 (project settings)> 播放器 (player))中选择。

内置 html 页面可以用来测试和显示最小化播放器,但是出于制作目的,通常来说看到播放器托管在最终部署的页面是大家所乐见的。例如,如果 unity 内容通过外部调用接口与页面上的其他元素交互,那么就必须经过提供这些交互元素的页面测试。unity 允许通过使用网络播放器模版提供自己的页面来托管播放器。

网络播放器模版的架构

通过在资源 (assets) 文件夹中创建一个名为 “webplayertemplates” 的文件夹将自定义模版添加到工程当中,模版本身为该文件夹下的子文件夹。每个模版文件夹包含一个 index.html 或 index.php 文件,以及页面需要的任何其他资源,如图像或样式表。

建完后模版会出现在播放器设置 (player settings) 检视器的选项中(模版名称与其文件夹名称相同)。视情况需要,文件夹可包含一个名为 thumbnail.png 的文件,尺寸为 128x128 像素。缩略图将显示在检视器中,提示完成的页面的显示效果。

模版标签

创建过程中,unity 会在页面文本中查找一个特殊的标签字符串,并以编辑器提供的值替换它们。其中包括名称、屏幕尺寸及关于播放器的许多其他有用信息。

在页面源代码中,标签限定在百分比符号 (%) 内。例如,如果产品名称在播放器设置 (player settings) 中定义为 “myplayer”:-

<title>%unity_web_name%</title>

…在模版的索引文件中会被替换为

<title>myplayer</title>

…生成构建的主机页。完整标签如下:-

unity_web_name

网络播放器的名称。

unity_width

unity_height

播放器屏幕的宽和高(以像素表示)。

unity_web_path

网络播放器文件的本地路径。

unity_unityobject_local

名为 unityobject2.js 的浏览器 javascript 文件一般用于嵌入主机页的播放器中,并提供unity 与主机 javascript 之间的部分交互。一般通过从 unity 网站上下载来提供给页面。但是需要有 internet 连接,如果页面从用户的硬盘驱动器中脱机部署,会引发问题。该标签为 unityobject.js 文件提供本地路径,如果在构建设置 (build settings) 中启用脱机部署 (offline deployment) 就会生成。

unity_unityobject_url

一般情况下,页面会从 unity 网站(例如禁用脱机部署 (offline deployment) 选项)上下载 unityobject2.js,该标签会提供下载链接。

unity_unityobject_dependencies

unityobject2.js 具有相关性,该标签会被所需的依赖关系替代,以便正常工作。

unity_beta_warning

如果网络播放器已发布了 unity 测试版,该标签会被一条有关该事实的简短警告信息所替代。否则不会被任何内容替代。

unity_custom_some_tag

如果以 unity_custom_xxx 的格式给索引文件添加标签,那么选择模版时该标签会出现在播放器设置 (player settings) 中。例如,如果像

<title>unity web player | %unity_custom_mytag%</title>

…这样的内容添加到源代码中,播放器设置 (player settings) 会变成:-

标签名称旁的文本框包含发布期间自定义标签会被替换的文本。

示例

为了说明模版标签的用法,以下是 unity 用于其默认网络播放器发布的 html 源代码。

unity web player |%unity_web_name%

%unity_beta_warning%

« created withunity»

相关阅读

文章点评
相关文章