[apache]: http://www.apache.org/licenses/LICENSE-2.0 "Apache V2 License" [documentation]: https://docs.ultraleap.com/unity-api/ "Ultraleap UnityPlugin Documentation" [xr-guidelines]: https://docs.ultraleap.com/xr-guidelines/ "XR Guidelines" [developer-site]: https://developer.leapmotion.com/ "Ultraleap Developer Site" [developer-site-tracking-software]: https://developer.leapmotion.com/tracking-software-download "Ultraleap Tracking Software" [developer-site-setup-camera]: https://developer.leapmotion.com/setup-camera "Ultraleap Setup Camera" [developer-site-unity]: https://developer.leapmotion.com/unity/ "Ultraleap Developer site - Unity" [developer-forum]: https://forums.leapmotion.com/ "Developer Forum" [discord]: https://discord.com/invite/3VCndThqxS "Discord Server" [github-discussions]: https://github.com/ultraleap/UnityPlugin/discussions "Github Discussions" [releases]: https://github.com/ultraleap/UnityPlugin/releases "UnityPlugin releases" [repository-url]: https://github.com/ultraleap/UnityPlugin.git "Repository URL" [repository-tags]: https://github.com/ultraleap/UnityPlugin/tags "UnityPlugin tags" [upgrade-urp]: https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@7.1/manual/upgrading-your-shaders.html "Unity URP Upgrade Documentation" [upgrade-hdrp]: https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@7.1/manual/Upgrading-To-HDRP.html "Unity HDRP Upgrade Documentation" [upgrade-xr]: https://docs.unity3d.com/Manual/configuring-project-for-xr.html "Unity XR Upgrade Documentation" [package-manager]: https://docs.unity3d.com/Manual/Packages.html "Unity Package Manager Documentation" [upm-giturl-installing]: https://docs.unity3d.com/Manual/upm-ui-giturl.html "Installing a UPM package from a Git URL" [upm-giturl-dependencies]: https://docs.unity3d.com/Manual/upm-git.html "UPM Git dependencies" [upm-giturl-revision]: https://docs.unity3d.com/Manual/upm-git.html#revision "Targeting a specific revision" [upm-giturl-locks]: https://docs.unity3d.com/Manual/upm-git.html#git-locks "Locked Git dependencies" [upm-localpath]: https://docs.unity3d.com/Manual/upm-localpath.html "UPM local packages" [upm-troubleshooting]: https://docs.unity3d.com/Manual/upm-errors.html "UPM Troubleshooting Page" [oculus-xr-documentation]: http://docs.unity3d.com/Packages/com.unity.xr.oculus@1.4/manual/index.html "Oculus XR package" [openupm-cli]: https://openupm.com/docs/getting-started.html#installing-openupm-cli "OpenUPM CLI" # Ultraleap Unity Plugin [![documentation](https://camo.githubusercontent.com/f2d7e5ef27f8bc4ab42e0d548ca9e6bfe997be13618d00f58344d929ccd578db/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f63756d656e746174696f6e2d646f63732e756c7472616c6561702e636f6d2d303063663735)][documentation] [![mail](https://camo.githubusercontent.com/b1f0a5572df89b5dcf1cfc87a2fa44bc1c3af99656b734a20a3c984fabc7c23f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e746163742d737570706f7274253430756c7472616c6561702e636f6d2d303063663735)](https://github.com/ultraleap/UnityPlugin/raw/develop/mailto:support@ultraleap.com) [![discord](https://camo.githubusercontent.com/fe29d1ef163293ba2b88d04a716f97b9de20aff613a7e36d9a4aa1580c65fb17/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446973636f72642d5365727665722d626c756576696f6c6574)][discord] ![GitHub](https://camo.githubusercontent.com/a295fe370acaf95926c4a5d71160d7f6b0ccf046939eb9ca6877f5e2296a9d15/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f756c7472616c6561702f556e697479506c7567696e) [![openupm-tracking](https://camo.githubusercontent.com/ba8e67c3af2c05f13377e07e50962ac9dd0fe060510530a6b4c439dc2002304a/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f636f6d2e756c7472616c6561702e747261636b696e673f6c6162656c3d4f70656e55504d253230547261636b696e672672656769737472795f7572693d68747470733a2f2f7061636b6167652e6f70656e75706d2e636f6d)](https://openupm.com/packages/com.ultraleap.tracking/) [![openupm-tracking-preview](https://camo.githubusercontent.com/ea63cad3d9a75e0f6d3d6bc586c0fd659ea5e3ded50950e5601410c7efb9d638/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f636f6d2e756c7472616c6561702e747261636b696e672e707265766965773f6c6162656c3d4f70656e55504d253230547261636b696e67253230507265766965772672656769737472795f7572693d68747470733a2f2f7061636b6167652e6f70656e75706d2e636f6d)](https://openupm.com/packages/com.ultraleap.tracking.preview/) The Ultraleap Unity Plugin empowers developers to build Unity applications using Ultraleap's hand tracking technology. It includes various assets, examples, and utilities that make it easy to design and build applications using hand tracking in XR projects. |

[![Downloading the Plugin](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/UL-Icon.png)](https://github.com/ultraleap/UnityPlugin/raw/develop/#Installation)
[Downloading the Plugin](https://github.com/ultraleap/UnityPlugin/raw/develop/#Installation)

[![Feature Guides](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/UL-Icon2.png)](https://docs.ultraleap.com/unity-api/#)
[Feature Guides](https://docs.ultraleap.com/unity-api/#)

[![Contributing](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/UL-Icon3.png)](https://github.com/ultraleap/UnityPlugin/raw/develop/#Contributing)
[Contributing](https://github.com/ultraleap/UnityPlugin/raw/develop/#Contributing)

| |:---|:---|:---| | Get set up with the Ultraleap Plugin for Unity. | Discover the available features of the Ultraleap Plugin for Unity. | Contribute to the Open Source repository to make your mark and help others. | ## Getting Started To use this plugin you will need the following: 1. The latest Ultraleap Hand Tracking Software. You can get this [here][developer-site-tracking-software]. 2. An Ultraleap Hand Tracking Camera - follow setup process [here][developer-site-setup-camera]. 3. Unity 2021.3 LTS or newer. UnityPlugin packages have been tested to work against 2021.3 LTS and 2022.3 LTS. 5. Follow one of the Installation workflows listed below. More detailed Getting Started documentation is available on [our website][documentation] **Please note:** - Due to the ever changing landscape of package dependencies in Unity we cannot guarantee compatibility with every plugin or variant of Unity, but aim to provide support for any LTS versions that are under continuous support from Unity. - If you are sourcing the Unity Plugin directly from this repository, you may find that it does not function well with earlier versions of Unity. ## Installation There are several ways you can consume this plugin. We've listed several recommended workflows for different users below. This list is by no means exhaustive ### OpenUPM (Recommended) This workflow is the easiest way to get up and running and makes updating packages simple. If you are familiar with OpenUPM, follow the [OpenUPM instructions](https://openupm.com/packages/com.ultraleap.tracking/#modal-manualinstallation). #### OpenUPM Setup Setup only needs to be performed once per Unity project. In `Edit -> Project Settings -> Package Manager`, add a new scoped registry with the following details: Name: Ultraleap URL: https://package.openupm.com Scope(s): com.ultraleap ![scoped_registry.png](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/scopedregistry.png) #### OpenUPM Adding, Upgrading or Removing Packages Open the Package Manager (`Window -> Package Manager`) and navigate to "My Registries" in the dropdown at the top left of the window. ![my_registries.png](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/myregistries.png) Ultraleap UPM packages should be available in the list. Click on the package you wish to install/modify. Note: Ultraleap Tracking contains the Core, Hands and Interaction Engine modules. There are older packages created independently by a third party for these modules that are no longer updated. ![packagelist.png](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/packagelist.png) (Optional) When clicking the package, it will automatically select the latest version. If you want to pick or change to a different version, click the arrow on the left of the package name and then "See all versions". ![packageversions.png](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/packageversions.png) The package can be installed or removed using buttons in the bottom right. (The install button is replaced with "Upgrade to \" if the package is currently installed) ![packageinstall.png](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/packageinstall.png) #### OpenUPM CLI If you prefer to use a CLI to modify your packages or need to be able to perform actions from a terminal (e.g. CI) then you may find the OpenUPM CLI helpful. See [Getting Started with OpenUPM-CLI][openupm-cli]. ### Unity Package (Legacy) You can find the .unitypackage releases of the Ultraleap Pugin for Unity attached to each release [here](https://github.com/ultraleap/UnityPlugin/releases) Please note, .unitypackages do not handle package dependencies or updates and is therefore only recommended if you wish to modify the package. Detailed instructions are available in the foldout below.

Legacy .unitypackage

#### .unitypackage Summary .unitypackage files are the legacy consumption method available if you prefer it or which still can be helpful if you: 1. need to modify the package content _and_ 2. don't expect to upgrade to a newer version > If you don't need to modify package content, the OpenUPM Consumer workflow is recommended. > If you do and expect to upgrade to a newer version, the Local UPM Package Contributor workflow is recommended as it enables you to version control your changes using git and resolve any potential conflicts when upgrading. #### .unitypackage Adding 1. Import the package (`Assets -> Import Package -> Custom Package`) which can be downloaded from [our Unity developer site][developer-site-unity] or the [releases section][releases] of this repository. #### .unitypackage Upgrading 1. (Optional) If you have made any changes to a package you may want to save those changes elsewhere. 1. Delete the package content you want to upgrade from `Assets/ThirdParty/Ultraleap`. 1. Import the .unitypackage you wish to change to. #### .unitypackage Removing 1. Delete the package you want to remove from `Assets/ThirdParty/Ultraleap`.

### Contributor Workflows Contributor workflows are used by UnityPlugin developers and are recommended for community members that want to contribute back to the source repository.

Local UPM Package

#### Local UPM Package Summary This workflow takes a few steps to setup and enables you to: - Modify UPM package content from within one (or many) Unity project(s). - Manage changes using git. - Contribute changes back to the remote repository. (Note) [Git LFS](https://git-lfs.com/) is required when importing via this method. #### Local UPM Package Setup 1. Clone or submodule the [repository][repository-url]. 1. The repository should not be cloned/submoduled into Unity reserved project folders, i.e. Assets, Library, ProjectSettings or Packages. Creating another folder such as "LocalPackages" is recommended. 1. (Note) If you don't plan to share your project and would like to use the same UPM packages across multiple Unity projects it may be ideal to clone to a common place on your machine. #### Local UPM Package Adding You can add packages from the repository to your project in one of two ways: 1. (Sharable) Edit your project manifest.json (`Project/Packages/manifest.json`) to add the relative paths from your Unity project's Packages folder to the Packages in the repository Packages folder. For more information see the [Unity Manual][upm-localpath]. Below is an example if you had cloned the repository to LocalPackages within your Unity project. "com.ultraleap.tracking": "file:../LocalPackages/unityplugin/Packages/Tracking", "com.ultraleap.tracking.preview": "file:../LocalPackages/unityplugin/Packages/Tracking Preview", 1. (Not sharable) Open the package manager (`Window -> Package Manager`) and click "Add package from disk…". Point it to the desired package within the repository `Packages` folder. Repeat to add all the packages you want to reference locally. *This will use an absolute file path from your machine, so will not be a sharable solution without modifying the path to work on the new machine.* #### Local UPM Package Upgrading Changing package versions is done through the git repository itself. Released versions can be found by checking the repository tags. #### Local UPM Package Removing 1. Open the package manager (`Window -> Package Manager`). 1. Navigate to "In Project" in the dropdown. ![packagesinproject.png](https://github.com/ultraleap/UnityPlugin/raw/develop/Markdown/images/packagesinproject.png) 1. Select the package you want to remove and click remove in the bottom right.

## Contributing Our vision is to make it as easy as possible to design the best user experience for hand tracking use cases in XR. We learn and are inspired by the creations from our open source community - any contributions you make are greatly appreciated. 1. Fork the Project 2. Create your Feature Branch: git checkout -b feature/AmazingFeature 3. Commit your Changes: git commit -m "Add some AmazingFeature" 4. Push to the Branch: git push origin feature/AmazingFeature 5. Open a Pull Request ## License Use of Ultraleap's Unity Plugin is subject to the [Apache V2 License Agreement][apache]. ## Community Support Our [Discord Server][discord], [Github Discussions][github-discussions] and [Developer Forum][developer-forum] are places where you are actively encouraged to share your questions, insights, ideas, feature requests and projects. ## Links [Ultraleap Unity Plugin][repository-url] [Documentation][documentation]