Autodesk Forge 学习简谈 - 1

随着Forge技术的迅猛发展和应用的丰富，以前的一些资料和样例业已过时，将对学习《简谈系列》做一定调整。我们中国区团队不断的增加中文的材料，但由于全球业务的繁忙，不是很能及时的整理和撰写，所以敬请大家更及时关注[授以渔 - Autodesk Forge 学习简谈 - 引言提到的资源

---

就上文提到的四类常见咨询内容，本文介绍第一类：刚刚接触Forge的朋友，想快速入门，材料，教程。
(注：本文提及的资源链接若访问不了，请尝试VPN)

Forge是云服务集合的平台，云服务都是Restful形式提供的，调用过程大多在网络应用的服务器端完成，所以若您还不了解Restful，请通过网上材料查看一下。无特别推荐，此类信息已经很多了。由于Restful众多开发语言都支持，因此选用您自己擅长或者业务需要的开发方式即可。个人较为推荐Node.js的方式，而使用Node，可以用的工具有WebStorm （需要收费），或Visual Code （目前免费）。另外，选用合适业务的方式搭建服务器，部署服务器。现在网上有很多不错的快速部署工具，例如Heroku，Appharbor。当然还有常见的巨头，AWS，Azure，阿里云等。

可能很多朋友一开始想了解Forge是因为Forge Viewer (网页模型浏览和数据查看，业务集成和对接），它是一套JavaScript API，属于客户端的API。也就意味着，您需要熟悉JavaScript的编程。

而Forge不只是Forge Viewer一个内容，使用Forge Viewer，模型要首先用Forge服务转换浏览器支持的格式，也就是说，后面其实包含了几个服务：Authentication (OAuth)，Data Management API，Model Derivative API。
Forge还有【云端自动化设计】云服务，【照片建模】云服务，【BIM 360】等云服务，这些都是Restful方式的API，

以下主要就Forge Viewer方面的内容整理，后续还会对其它云服务做资料介绍。

若大家想一开始想测试模型在网页中展示，但不想编程，可以有几个方式：

• 在Autodesk的SaaS产品中上载模型查看，例如

  • Autodesk360: https://a360.autodesk.com/ (有免费的版本）。可以上载适度的超大模型
  • BIM 360： 覆盖BIM全生命周期的云平台，其Docs（文档项目施工管理）模块试用期30天：https://www.autodesk.com/bim-...。可以上载超大模型。
• 模型网页查看分享：https://viewer.autodesk.com/。免费上载模型，分享，查看，分享链接有效期30天，可以手动续有效期。大模型可能无法上载成功。
• 模型管理器：是基于Forge的服务，Node.js 框架下创建的样例，
  https://oss-manager.autodesk.io
  只需申请Forge开发账号，创建app，得到client id，client secret，填写到样例即可使用。它也是大家进行分析诊断非常方便的工具。源代码也提供了，可以根据自己的需要扩容或更新。https://github.com/Autodesk-F...

如果对编程不是太熟悉，想尝试代码，推荐此英文教程，按照其步骤，填写有关信息，最终形成一个在本地能运行的网络应用
https://forge.autodesk.com/de... 。源代码在:https://github.com/Autodesk-F...

若已具备一定的编程基础，开始具体学习如何编程使用Forge Viewer技术，请务必参考 Learn Forge tutorial - 向导式Forge进阶教程。我们部门顾问康益升老师做了专门的演讲，演示如何使用该教程:Forge Viewer案例从搭建到部署.

当深入到Forge Viewer端的应用细节，会更多使用Viewer的扩展，以及自己撰写扩展。可参考此代码样例：http://forge-extensions.autod...。该样例列出了可用默认扩展，加载卸载查看效果。也不断提供自定义扩展，例如物体标签，viewer内嵌小viewer，移动物体，动态附着自定义属性等。源码在：
https://github.com/Autodesk-F...

网路应用，还会经常对服务端口做调试，这方面我们推荐Postman，从此博客可以下载与Forge Viewer应用有关的Postman测试脚本：
https://forge.autodesk.com/bl...

---以下是旧版的简谈，有些样例不再维护，有些还可以继续参考-----
请使用此【测试网站】开始体验，填入自己的client id和secret，点击【Get Access Token】，跳转到一个页面，包括上载模型，启动转换，查看结果，加载模型到网页等，还有token有效期倒计时。

在前年的Forge Viewer技术研讨会上，我们的同事罗诗亚做过专门的过程讲解，视频清晰度在优酷上被压缩的厉害，可配合她用到的在线PPT查看。其主要的过程和上面提到的测试体验网站类似。当时Forge Viewer和背后几个技术统称为Viewer and Data。只是名字而已。

通过这些材料，逐步熟悉几个主要的概念：申请app, 开发key & secret, token, bucket, urn, translate, viewer 等。有了这个体会后教学基础后，您就可以开始上手练习了。

如果您已经熟悉模型转换的过程，只是更多关注Forge Viewer客户端的开发，则可以先从我们同事吴忠的课件开始。其分支包括了Forge Viewer一些常见开发内容的代码，例如自定义工具条，操作对象，实现拓展（extension）等。虽然此课件用的Node.js搭建的服务，但主要用来得到token，假设不熟悉Node.js也不用担心，主要关注客户端，借鉴到您的应用实现。

也推荐另外一个类似的课程系列（全英文），用的Node.js + WebPack进行讲解。涵盖了以下内容:

1. viewer-offline将Forge转换的网页浏览数据部署到自己服务器，通常叫做离线查看（offline）进行查看。这属于中级课程，可先略过
2. viewer-barebone：无需服务器端代码，需要通过其它工具产生token和模型的urn，填写到JavaScript代码中，实现模型的加载
3. viewer+server：服务器端完成token的产生工作，其它内容（例如模型上传，转换）通过其它工具完成，填写到JavaScript代码中，实现模型的加载
4. viewer+server+oss: 服务器端完成token的产生和模型上传工作，其它内容（例如模型转换）通过其它工具完成，实现模型的加载
5. viewer+server+oss+derivatives: 服务器端完成后端所有工作（token的产生，模型上传，模型转换），客户端实现模型的加载

如果您是想开始Forge其它云服务的过程，例如云端设计自动化（Design Automation），则可以先通过此在线PPT熟悉主要的概念和流程：app，开发key & secret, token，Activity，WorkItem，AppPackage等。此材料链接到了一些英文材料，也可按照指南参考。

其它的服务例如BIM 360， Reality Capture（照片建模）等服务，我们陆续会介绍有关材料。

下一篇： 常见场景的代码样例，常见问题的诊断技巧