AR.js README

The project's README from github.com/jeromeetienne/AR.js. As one markdown file: README.md.

AR.js - Augmented Reality for the Web

Logo by Simon Poulter


npm npm Build Status
Gitter chat Patreon donate button Twitter Follow Twitter Follow

AR.js is a lightweight library for Augmented Reality on the Web, coming with features like Marker based and Location based AR.

⚠️ This project repository has been moved to a Github organization account ⚠️

The old repository (the one you are now) will be left up, so all links and CDNs will continue to be available, but this version will not be updated anymore.

⚠️ AR.js repository has been moved, please check it out at: https://github.com/AR-js-org/AR.js ⚠️

Please, open issues and Pull Requests on the new repository: https://github.com/AR-js-org/AR.js

Thank you.

Why move AR.js

AR.js was among those great projects, with great technologies, often disruptive ones, that eventually were lacking from documentation and support.

We tried to carry on the author's terrific work by maintaining this project, handling new versions, issues, pull requests, the community itself. We continued promoting this project through blogs, Medium articles, socials. And we released new features, like the Location Based AR that was not initially present on AR.js.

Now, that we are also ready to ship a new feature, Image Tracking, we feel ready to start a new path, and so we have created a new repository that is not owned by individuals, but by one organization.

Anyone can be added to it, and more people will manage it, in order to make the project more collaborative and avoid "bottlenecks".

We feel this is a new chapter for this project, to not let it die alone. We feel the current Web Augmented Reality market really needed something like AR.js, but only if owned by no-one apart from the community itself. A technology free and Open Source, created by users for the users.

We'd like to thank all contributors and passionate people who help us in this journey.

On the new repository, you will find all the feature you already had here, plus:

See you on new AR.js org.

Nicolò Carpignoli


AR.js is a free and Open Source software, created by @jeromeetienne and maintained by @nicolocarpignoli. Check the LICENSE.txt to learn more.

AR.js (jeromeetienne/AR.js)

Searching Database…

15.8K ·GitHub
这是什么?AR.js 是一个轻量级的网页增强现实库。它可以让你构建直接在浏览器中运行的 AR 体验,同时支持基于标记和基于地理位置的 AR。
所以它是一个写代码用的 JavaScript 库,而不是手机应用?没错——把它引入网页后,AR 就在访客的浏览器里运行。它基于 A-Frame 和 three.js 构建,所以你只需描述 3D 场景,而不用编写原生移动端代码。
怎么把它加到项目里?把 AR.js 脚本引入你的网页,再用浏览器打开即可——不需要原生 SDK,也不用打包应用。这个仓库里的 CDN 链接仍然可用,持续维护的仓库则提供最新的文档和示例。
这个仓库还是该用的那个吗?不是——AR.js 已经迁移到一个社区运营的 GitHub 组织。这个旧仓库保留下来只是为了让已有的链接继续有效;要获取更新、提交 issue 和 pull request,请前往新仓库。
在手机上能流畅运行吗?这正是该项目的主打卖点:在移动设备上以 60fps 高效运行网页 AR。由于一切都运行在浏览器里,用户只需打开你的页面——不用从应用商店安装任何东西。
可以在自己的项目里免费使用吗?可以——AR.js 是基于 MIT 许可证的免费开源软件。它由 Jerome Etienne 创建,目前由 Nicolo Carpignoli 维护。
它支持哪些 AR 模式?一种是基于标记的 AR,由摄像头识别打印出来的标记;另一种是基于地理位置的 AR,把内容固定在真实世界的坐标上。持续维护的版本还新增了图像跟踪作为第三种模式。
这个项目为什么要迁移到 GitHub 组织?为了让社区而非个人来拥有它:任何人都可以被加入,更多人来管理发布和 issue,项目也就避免了依赖单一维护者的瓶颈。
相比这个版本,持续维护的版本多了什么?包含这里的全部内容,另外新增了 Image Tracking、更多可以边做边学的示例、一个全新的参与贡献入口,以及一个新的文档网站。
Size
319.7 MB
Stars
15.8K
Updated
CommitMar 15
Age
9y
Commits · 90 Days