Creating and managing spaces
OKO Web Client 2.24.1 CSP 4.19.0
This article will guide you through creating a new space in OKO Web and managing it.
Instructions
Create a space
After logging into your OKO account, you'll arrive at the Home Page. Look for the 'Create New Space' button in the upper right corner of the screen and click to start.
The following page will appear.
From here, you will be able to define the properties of your space. First, give your space a name and add an optional description.
From this page, you can also add a thumbnail image of your space by selecting “Browse”.
OKO supports either a PNG or JPEG format.
Once you upload your image, you’ll be able to see a preview of it on the right:
Selecting an Environment
Next, you'll need to select an environment for your space.
To start, select “Scene” at the top of the page.
To simplify things, we've provided some templates to help you get started. These templates range from a basic empty space with default skybox and lighting settings to more complex environments like a gallery.
To pick a template for your space, select the “Template” icon.
Next, choose the option that suits your needs best, then click “Save”.
Geolocating your space
You can make your space geolocated by entering latitude and longitude coordinates to give it a real-world location. By making a space geolocated it means it can be viewed by people at a specific physical location.
Geolocated spaces are great, for example, if you want to create an engaging augmented reality experience. Users who are physically at the same location will see each other represented in the virtual space and be able to enjoy the same virtual content combined with their view of the real world.
To start setting this up, select “Location” at the top of the page, then select “Add Location”.
Here you can add the latitude and longitude coordinates of your space.
If you are unsure of the latitude and longitude coordinates of a location, you can find them easily via Google Maps. Simply find the location you want, right-click it in the map and a pop-up will appear with the latitude and longitude of that location displayed at the top. These coordinates can then be entered into the fields provided.
Alternatively, you can find the location interactively using our Mapbox integration.
Click on the map to open Mapbox, as shown below.
The pin at the center of the screen denotes the position at which your new space will be located. To update the position, left-click and drag to move the map view beneath the pin. You can also use your scroll wheel to zoom in and out for more precise placement.
Once you are happy with the selected location, click the tick to accept it and the coordinates will automatically be added to the corresponding latitude and longitude fields for your space.
Share settings
Next, you can decide how you would like invited users to interact with your space. Select the “Share” button at the top of the page.
Invited users can have one of two roles; Creator or Viewer. Creators can edit and collaborate on the creation of the space with you, whereas a Viewer cannot make edits to the space.
Simply add their email address and choose their role and they’ll appear in the list. You can come back to remove and add users and change their roles at any time.
Additional settings
Finally, there are some additional settings you may want to explore for your space.
Select “Settings” at the top of the page to see the below list:
Ticketed | You can make your space ticketed via our Eventbrite integration. For more information please refer to this link. |
Commerce | You can add e-commerce to your space via our Shopify integration. For more information please refer to this link. |
Template | You can make your space available as a template for other users. Note that the space must be set to Public for this to work. |
Virtual Camera Mode | You can enable virtual camera style controls for Android devices. |
Launch in AR Mode | You can enable visitors to be immediately placed in augmented reality (AR) mode. |
Launch in VR Mode | You can enable visitors to be immediately placed in virtual reality (VR) mode. |
Visitor Settings | You can enable visitors to be launched into an instanced space. Visitors will be able to be alone or invite friends. |
You are now ready to “Create” your space!
Note: Should you need to change any of the previous settings on your space, you can do this at any time from the main page. Simply select the two-dot menu, then click “Edit”.
Create and Enter a space
Now that you’ve adjusted all your space settings, you can select “Create” to create the space and return to the main page, or select “Create & Enter” to immediately enter the space you have created.
Once you enter the space, you can find additional space settings on the left and right side of the page, as shown below.
Click on “Share” to add additional users and decide if they are Viewers or Creators.
You can return to this section at any point to edit who has access to your space.
An alternative way to access your space settings
As mentioned earlier, if you return to the Home page and select the ‘Owned By You’ tab, you can search for your space, and then you will see two dots at the bottom right of the thumbnail:
Click on it, and select “Edit” to open space settings, or select “Delete” to delete the space.
You can also share your space from here using either the “Share” or “Copy Link” buttons.
When opening the space settings, you will see all the same options as before. You can change the thumbnail, display name, and description of your space.
You can add a Location if you haven’t already using the “Location” tab.
You can manage visitors to your space in the “Share” tab.
And you can make your space public, ticketed, or commercial, at any time.
We hope you enjoy creating spaces of your own!