├── .gitignore ├── AirAPI_Example_0.2.0Build1.zip ├── LICENSE └── README.md /.gitignore: -------------------------------------------------------------------------------- 1 | # Xcode 2 | # 3 | # gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore 4 | 5 | ## User settings 6 | xcuserdata/ 7 | 8 | ## compatibility with Xcode 8 and earlier (ignoring not required starting Xcode 9) 9 | *.xcscmblueprint 10 | *.xccheckout 11 | 12 | ## compatibility with Xcode 3 and earlier (ignoring not required starting Xcode 4) 13 | build/ 14 | DerivedData/ 15 | *.moved-aside 16 | *.pbxuser 17 | !default.pbxuser 18 | *.mode1v3 19 | !default.mode1v3 20 | *.mode2v3 21 | !default.mode2v3 22 | *.perspectivev3 23 | !default.perspectivev3 24 | 25 | ## Obj-C/Swift specific 26 | *.hmap 27 | 28 | ## App packaging 29 | *.ipa 30 | *.dSYM.zip 31 | *.dSYM 32 | 33 | ## Playgrounds 34 | timeline.xctimeline 35 | playground.xcworkspace 36 | 37 | # Swift Package Manager 38 | # 39 | # Add this line if you want to avoid checking in source code from Swift Package Manager dependencies. 40 | # Packages/ 41 | # Package.pins 42 | # Package.resolved 43 | # *.xcodeproj 44 | # 45 | # Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata 46 | # hence it is not needed unless you have added a package configuration file to your project 47 | # .swiftpm 48 | 49 | .build/ 50 | 51 | # CocoaPods 52 | # 53 | # We recommend against adding the Pods directory to your .gitignore. However 54 | # you should judge for yourself, the pros and cons are mentioned at: 55 | # https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control 56 | # 57 | # Pods/ 58 | # 59 | # Add this line if you want to avoid checking in source code from the Xcode workspace 60 | # *.xcworkspace 61 | 62 | # Carthage 63 | # 64 | # Add this line if you want to avoid checking in source code from Carthage dependencies. 65 | # Carthage/Checkouts 66 | 67 | Carthage/Build/ 68 | 69 | # Accio dependency management 70 | Dependencies/ 71 | .accio/ 72 | 73 | # fastlane 74 | # 75 | # It is recommended to not store the screenshots in the git repo. 76 | # Instead, use fastlane to re-generate the screenshots whenever they are needed. 77 | # For more information about the recommended setup visit: 78 | # https://docs.fastlane.tools/best-practices/source-control/#source-control 79 | 80 | fastlane/report.xml 81 | fastlane/Preview.html 82 | fastlane/screenshots/**/*.png 83 | fastlane/test_output 84 | 85 | # Code Injection 86 | # 87 | # After new code Injection tools there's a generated folder /iOSInjectionProject 88 | # https://github.com/johnno1962/injectionforxcode 89 | 90 | iOSInjectionProject/ 91 | 92 | # mac stuff 93 | *.DS_Store 94 | -------------------------------------------------------------------------------- /AirAPI_Example_0.2.0Build1.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/GigabiteLabs/AirAPI_Mac-Dist/4a5b926daf18d0392715e638a9da1fe499e4a2c6/AirAPI_Example_0.2.0Build1.zip -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2023 GigabiteLabs 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # AirAPI_Mac-Dist 2 | Pre-release versions of AirAPI SDK apps for macOS. 3 | 4 | ## Release Info 5 | 6 | - 0.2.0, build 1: Pre-alpha update to the test bench & telemetry project for Nreal Air. 7 | 8 | ### Latest Release Notes: 9 | 10 | Updates / Fixes 11 | 12 | - Everything is pre-built and included within the application-- it should "just work" 13 | 14 | - After much R&D, the underlying libraries are now compiled and using CMake such that they are directly included with the app-- no more weird developer stuff with installing hidapi, or putting things on path (you can remove them now if you installed 0.1.0) 15 | 16 | - Fixed crash on "stop connection" 17 | 18 | - Was due to an underlying c++ threading issue which is now resolved when disconnecting 19 | 20 | 21 | Notes: 22 | 23 | - In order to simplify the R&D, the ability to build for M-Series was temporarily disabled in Xcode-- but it should still run on M-Series with Rosetta 24 | 25 | - Please let us know if you are able to run with Rosetta on M-Series 26 | 27 | - If you have any crashes or issues, please [go to issues](https://github.com/GigabiteLabs/AirAPI_Mac-Dist/issues) and create a report-- more information is better, if you can include a crash report that would be 100% best (like this fine tester, [right here](https://github.com/GigabiteLabs/AirAPI_Mac-Dist/issues/1)) 28 | 29 | - No major changes or improvements to the UI were done in this build, this one is purely about smoothing out the ability to run the app, and making it as accessible to as many mac users as possible. 30 | 31 | 32 | Known Issues: 33 | 34 | - The window is not resizable, and may be too large on some macs to see all of the buttons macs 35 | 36 | - apologies, this is an autolayout bug that was just beyond the goal of this release 37 | 38 | - this will be fixed in the next release. 39 | 40 | - Connection status UI does not ever update or reflect the actual status 41 | 42 | - on it, will be resolved in the next release 43 | 44 | 45 | ## How to install 46 | 47 | Disclaimer: this project is aimed at fellow developers and power users, proceed with caution. 48 | 49 | 1. Download the latest release from the "releases" option on the right sidebar -> 50 | 51 | 2. Unzip on your Mac 52 | 53 | 3. You will find AirAPI_Example.app 54 | 55 | 4. Open another finder window and move AirAPIExample.app to your `/Applications` folder 56 | 57 | 5. Launch it: 58 | 59 | - You will be warnied by Apple that this app is unsafe etc-- it's safe. 60 | 61 | - To launch: go to `~/Applications` in Finder and use `option + right-click` and then click "open". Then clock "open" again, this will by-pass gatekeeper 62 | 63 | - If the above doesn't work and you can't open it, to to your settings and [make sure you allow apps from "trusted developers"](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) and click this link if you have any more issues 64 | 65 | That's it, now plug in your Nreal Air and click "connect" (if the globe does not automatically start tracking your Nreal Air postitional updates) 66 | 67 | ## Compatibility 68 | 69 | This SDK is verified compatible with the following: 70 | 71 | - macOS Ventura (Intel) 72 | - Swift v5^ & and Xcode 14^ 73 | - SceneKit 74 | - RealityKit 75 | 76 | We need your feedback about M-Series-- did it work for you? If not, please get in touch or submit a [git issue](https://github.com/GigabiteLabs/AirAPI_Mac-Dist/issues) --------------------------------------------------------------------------------