# AR.js
**Repository Path**: hades_c/AR.js
## Basic Information
- **Project Name**: AR.js
- **Description**: AR.js 是一款应用于 Web 的高效增强现实（AR）库
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 59
- **Created**: 2017-11-09
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# AR.js - Augmented Reality on the Web
---
[](https://travis-ci.org/jeromeetienne/AR.js)
[](https://gitter.im/AR-js/Lobby)
[](https://twitter.com/nicolocarp)
[](https://twitter.com/jerome_etienne)
AR.js is a lightweight library for Augmented Reality on the Web, coming with features like Image Tracking, Location-based AR and Marker tracking.
Welcome to the official repository!
This project has been created by [@jeromeetienne](https://github.com/jeromeetienne) and it is now maintained by [@nicolocarpignoli](https://github.com/nicolocarpignoli).
🚀For frequent updates on AR.js you can follow [@nicolocarp](https://twitter.com/nicolocarp) and Watch this repo!
Logo is courtesy of Simon Poulter .
------
You can get paid support and new features for AR.js. Check this link.
------
### ⚡️AR.js has now an official Documentation!⚡️
### Check it out: [AR.js Official Documentation](https://ar-js-org.github.io/AR.js-Docs/).
If you want to give a first look at AR.js potential, you can continue with this Readme.
-----
⚡️ AR.js is coming in two, different builds. They are both maintained. They are exclusive.
Please import the one you need for your project, not both:
- **AR.js with Image Tracking + Location Based AR:**
- AFRAME version: https://raw.githack.com/AR-js-org/AR.js/master/aframe/build/aframe-ar-nft.js
- three.js version: https://raw.githack.com/AR-js-org/AR.js/master/three.js/build/ar-nft.js
- **AR.js with Marker Tracking + Location Based AR:**
- AFRAME version: https://raw.githack.com/AR-js-org/AR.js/master/aframe/build/aframe-ar.js
- three.js version: https://raw.githack.com/AR-js-org/AR.js/master/three.js/build/ar.js
You can also import a specific version replacing `master` keyword with version tag:
```html
```
### 🌍Location Based Example
Please follow these simple steps:
- Create a new project with the following snippet, and change `add-your-latitude` and `add-your-longitude` with your latitude and longitude, without the `<>`.
- Run it on a server
- Activate GPS on your phone and navigate to the example URL
- Look around. You should see the text looking at you, appearing in the requested position, even if you look around and move.
```html
GeoAR.js demo
```
### 🔲 Marker Based Example
Please follow this simple steps:
- Create a new project with the code below (or [open this live example](https://ar-js-org.github.io/AR.js/aframe/examples/marker-based/basic.html) and go directly to the last step)
- Run it on a server
- Open the website on your phone
- Scan [this picture](https://raw.githubusercontent.com/AR-js-org/AR.js/master/data/images/hiro.png) to see content through the camera.
```html
```
Learn more on the [AR.js Official Documentation](https://ar-js-org.github.io/AR.js-Docs/).
## Troubleshooting, feature requests, community
**You can find a lot of help on the old [AR.js repositories issues](https://github.com/jeromeetienne/AR.js/issues). Please search on open/closed issues, you may find interesting stuff.**
### Contributing
From opening a bug report to creating a pull request: every contribution is
appreciated and welcome. If you're planning to implement a new feature or change
the api please create an issue first. This way we can ensure that your precious
work is not in vain.
### Issues
If you are having configuration or setup problems, please post
a question to [StackOverflow](https://stackoverflow.com/search?q=ar.js).
You can also address the question to us in our [Gitter chatroom](https://gitter.im/AR-js/Lobby)
**If you have discovered a bug or have a feature suggestion, feel free to create an issue on Github.**
### Submitting Changes
After getting some feedback, push to your fork and submit a pull request. We
may suggest some changes or improvements or alternatives, but for small changes
your pull request should be accepted quickly.
Some things that will increase the chance that your pull request is accepted:
* Follow the existing coding style
* Write a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)
## Licenses
It is **all open-source**! jsartoolkit5 is under LGPLv3 license and additional permission.
And All my code in AR.js repository is under MIT license. :)
For legal details, be sure to check [jsartoolkit5 license](https://github.com/artoolkitx/jsartoolkit5/blob/master/LICENSE.txt)
and [AR.js license](https://github.com/AR-js-org/AR.js/blob/master/LICENSE).
Full Changelog: [AR.js changelog](https://github.com/AR-js-org/AR.js/blob/master/CHANGELOG.md)