本教程将获得所有技能水平的开发人员和他们的第一个铯应用程序运行。
验证Cesium在您的Web浏览器中工作的最简单的方法是单击此处运行Hello World示例 (打开一个新窗口)。如果你看到像下面的图像,恭喜你的系统可以运行铯,你可以安全地跳到下一部分; 否则,继续阅读。
Cesium是基于几种新的HTML5技术构建的,其中最重要的是WebGL。即使这些新标准很快被广泛采用,一些浏览器和系统需要更新以支持它们。如果示例应用程序不适合您,请尝试以下几种方法。
- 更新您的网络浏览器。大多数Cesium团队使用Google Chrome,但Firefox,Internet Explorer 11和Opera也可以使用。如果您已经在使用上述其中一种浏览器,请确保更新到最新版本。
- 更新您的显卡驱动程序以更好地支持3D。如果您知道您的视频卡类型,您可以检查供应商网站的更新。三个最受欢迎的是:Nvidia,AMD和英特尔。
- 如果您仍遇到问题,请尝试访问http://get.webgl.org/,其中提供了其他问题排查建议。您也可以在Cesium论坛上寻求帮助。
选择编辑器或IDE
如果你已经是一个经验丰富的开发人员,你很可能有一个最喜欢的编辑器或开发环境; 例如,大多数铯团队使用Eclipse。如果你刚刚开始,一个伟大的免费和开源的编辑器是Notepad ++,你可以从他们的网站下载。最终任何文本编辑器都会做,所以去与你最舒适的。
下载铯释放
假设你还没有这样做,点击这个按钮抓住最新的铯释放: Cesium-1.30.zip
下载后,将zip文件解压到您选择的新目录中,我将在整个教程中将此文件称为Cesium root
目录。内容应该看起来像下面。
它可能是诱人的双击index.html
,但我们只会有失望的欢迎。为了使应用程序实际工作,它需要在Web服务器中运行。
为了运行Cesium应用程序,我们需要一个本地Web服务器来托管我们的文件。我们将使用Node.js来完成这个和其他教程。如果你已经有一个你想要使用的Web服务器,这也很好,只要确保托管我们在上一节中创建的根目录。铯没有服务器要求; 它完全是客户端。这意味着任何可以托管静态内容的Web服务器也可以托管Cesium。
使用Node.js设置Web服务器很容易,只需要3个步骤。1.从其网站安装Node.js ,可以使用默认安装设置。2.在Cesium根目录中打开命令shell,然后通过执行下载/安装所需的模块npm install
。这将在根目录中创建一个“node_modules”目录。3.最后,通过node server.js
在根目录中执行启动Web服务器。你应该看到类似下面的东西
你好(再次)世界!
现在我们已经启动并运行了一个Web服务器,我们可以启动浏览器并导航到http:// localhost:8080 / Apps / HelloWorld.html。这是我们在教程开始时用来测试WebGL的Hello World应用程序,但现在它运行在您自己的系统而不是Cesium网站上。如果我们HelloWorld.html
在编辑器中打开,我们会找到以下简单的应用程序。
<!DOCTYPE html> <html lang="en"> <head> <!-- Use correct character set. --> <meta charset="utf-8"> <!-- Tell IE to use the latest, best version. --> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <!-- Make the application on mobile take up the full browser screen and disable user scaling. --> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"> <title>Hello World!</title> <script src="../Build/Cesium/Cesium.js"></script> <style> @import url(../Build/Cesium/Widgets/widgets.css); html, body, #cesiumContainer { width: 100%; height: 100%; margin: 0; padding: 0; overflow: hidden; } </style> </head> <body> <div id="cesiumContainer"></div> <script> var viewer = new Cesium.Viewer('cesiumContainer'); </script> </body> </html>
这些是需要添加铯到应用程序的四行:
-
第一步是
Cesium.js
在脚本标记中包含。这定义了Cesium
对象,其中包含我们需要的一切。<script src="../Build/Cesium/Cesium.js"></script>
-
为了使用Cesium Viewer小部件,我们需要包括它的CSS。
@import url(../Build/Cesium/Widgets/widgets.css);
-
在HTML体中,我们创建一个div,供查看器生活。
<div id="cesiumContainer"></div>
-
最后,我们创建一个viewer的实例。
var viewer = new Cesium.Viewer('cesiumContainer');
恭喜,您已经启动并运行Cesium并准备开始编写自己的铯应用程序和网页。根据学习者的类型,您可能有兴趣查看其他教程,介绍主要的铯功能。如果你是一个tinkerer,那么Cesium Sandcastle是一个现场编码应用程序,它将允许你不仅查看几十个示例,而且查看和编辑它们的源代码,从应用程序中更新更改。最后,无论您如何学习,参考文档包含API的详细信息,是每个人的宝贵资源。