Experience shared AR with your own domain using the Auki network and portal kits, unlock limitless digital potential for your physical space.
Domains are digital representations of physical spaces, accessible by applications utilizing the Auki SDK. The Domain Mapping Tool (DMT) enables users to construct and manage these domains.
Create an account via the DMT Console or the DMT Mobile Application
Portals serve as access points to a domain. Order a portal kit today to unlock the Auki network and start building in your space.
Although ordering a portal kit is recommended for more durable and permanent domain installing, alternatively, you can make portals at home with your own printer for free
If printing your own portals:
1. Generate portals using the DMT Console or mobile application.
2. Ensure printer settings are configured to 100% scale to maintain the correct physical size of the portal.
Strategically place portals at likely entry points to the domain to optimize access to your domain.
Tips:
Avoid high-reflection areas to ensure accurate detection.
Prevent sharp shadows on portals, as they may interfere with functionality.
Log in to the DMT application and navigate to the Domains page.
Click the "Create Domain" button from the home screen.
Give your domain a name, your domain name will be public to applications being built on the Auki Network.
Select a domain server to host the domain.
Understanding domain servers
Domain servers host your domain and store associated data.
Options include:
- Hosting your own domain server.
- Utilizing a public domain server provided by Auki.
- Utilizing community provided domain servers
Portals can be placed into a domain using either
the Capture Flow or the Manual Flow.
The Manual Flow is ideal for smaller spaces, allowing direct placement of portals.
1a. Navigate to the Portals tab and click the "Manage" button.
1b. Add the first portal, ensuring it is placed on the floor to establish the coordinate system.
1c. Continue adding additional portals as you navigate the space.
If a portal’s position or orientation is incorrect, you can use the adjustments tools on the portal manage page.
Set relative position.
start by calibrating in to the domain so that the portals appear on the screen, the portal you calibrate into should be spot on.
Next select the anchor portal, this portal will be used to align the other portals.
Next, select the target portal or portals. input the correct distance between the anchor and target.
Press apply to save the changes.
Note:
When multiple target portals are selected, the distance will be calculated to the first selected target portal. all other selected target portals will move the same relative distance from the anchor portal.
Manual movement
Select the target portal, calibrate against a correctly positioned portal, and adjust using the joystick interface before applying.
Press apply to save the changes.
Set in alignment on axis
If the portals are placed in the real world are in a straight line, you can set them to be in alignment by selecting this option.
First, select all portals that are in a straight line. the anchor portal will determine the direction of the alignment.
Next, press the set in aling on axis button.
Finally, Press apply to save the changes.
Rotation can be adjusted in the following ways.
Align to domain grid
If you have placed all portals along a physical grid like floor tiles or something so that you know that they are supposed to be aligned.
You can force them to be aligned by selecting this option. it is important that the Origin portal is aligned to the physical grid.
First, select all portals that are aligned to the physical grid.
Next, press the align to domain grid button.
Finally, press apply to save the changes.
Set same rotation
If the portals are placed with the same rotation in the real world, but when you placed them something went wrong, you can set them to have the same rotation by selecting this option.
First, select the anchor portal, this portal will be used to align the other portals.
Next, select the target portal or portals.
Next, press the set same rotation button.
Finally, press apply to save the changes.
Note:
Adjusting rotation is not recommended, as it can cause issues with the domain.
The Capture Flow involves recording the physical space to map portals' relative positions, suitable for larger environments.
1a. Begin by focusing on a portal placed on the floor to establish the ground plane.
2b. Press the "Record" button to start capturing.
3c. Move slowly, ensuring the camera captures portals as you navigate the space.
Note:
For large spaces, multiple captures are required. Ensure each capture includes at least two portals from previous captures to enable seamless integration. The application will display a warning if captures lack shared portals.
2a. Uploading recordings
Press the upload button to upload all the recordings to the refinement server.
If you are seeing multiple capture groups, please see the FAQ section below.
Once the recordings are uploaded, you can send them to the refinement server.
2b. Sending to Refinement Server
Press the "Send to Refinement Server" you can choose to send it to the first avalible server that is hosted by auki or to a custom server that you host.
Monitor the refinement status in the Refinements tab of the application.
Applying captures or refinements sets portal positions into the domain, enabling their use in applications leveraging the Auki SDK.
- Apply captures to set portal positions.
- Apply refinements to incorporate enhanced accuracy from the refinement process.
Note:
This feature is experimental and is used to improve the accuracy of the domain. If you want to use this feature please contact us at support@aukilabs.com
Navigation meshes define accessible areas within the domain.
1a. Navigate to the Marking tab and click the "Manage" button to enter AR mode.
1b. Calibrate by focusing on a nearby portal until the virtual portal aligns correctly.
1c. Tap the screen to create a navigation mesh.
1d. Drag the edges to resize or reposition the mesh.
Note:
Ensure all navigation meshes overlap to maintain continuity.
Occlusion meshes indicate areas occupied by physical objects, enabling accurate rendering in AR applications.
2a. Navigate to the Marking tab, click the "Manage" button, and switch to the Occlusion Volume tab.
2b. Calibrate by focusing on a nearby portal until the virtual portal aligns correctly.
2c. Tap the screen to create an occlusion mesh.
2d. Drag the edges to resize or reposition the mesh.
Why do Portals appear Incorrectly in AR?
This issue may result from device position drift during portal placement or capture. To resolve:
1. Manually adjust portals as described in the Adjusting Portal Positions section.
2. Delete all portals and restart the placement or capture process, moving slowly to enhance accuracy.
Why are my AR objects not visible?
This is typically due to connectivity issues. Verify that:
1. Your device is connected to the internet.
2, The selected domain server is online.
Why are Portals incorrectly placed in the Domain?
Refer to the Adjusting Portal Positions section for guidance on correcting portal placement.
Why do i have multiple capture groups?
If you are seeing multiple capture groups,this means that one or more captures are missing overlapping portals.
If this happens, you can inspect each group to see which parts of you domain they represent.
Once you have identified which sections are missing, you can record more captures to overlap with the missing sections.
Domains: Digital maps of physical spaces, accessible by applications using the Auki SDK.
Auki SDK: A software development kit enabling applications to interact with domains and portals.
Portals: Physical markers serving as access points to a domain, detected by AR-enabled devices.
Domain Servers: Servers hosting domain data, either user-managed or provided by Auki.
Refinement: A process to enhance the accuracy of domain mapping, particularly for large-scale setups.
AR Objects: Digital elements placed within a domain, such as navigation or occlusion meshes.
Navigation Meshes: Digital constructs defining accessible areas within a domain.
Occlusion Meshes: Digital constructs indicating areas occupied by physical objects, aiding accurate AR rendering.