✏️ Edit Mode

Audio and Video

πŸ”Š Add Audio and Video into Your World

πŸ“Ί Add Spatial Audio and Video to an Asset

🎬 Sync Pre-Recorded Media
πŸŽ₯ Add MP4s to a Video Player Asset

Clickable Assets

πŸ‘ˆ Create Clickable Assets in Your World
πŸ’¬ Display Text
πŸŒ„ Display an Uploaded Image

πŸ”— Embed an External Website

πŸ“Ί Embed YouTube, Vimeo, or Twitch as an iframe

πŸ–ΌοΈ Embed an External Image, Document, or PDF

Clickable Destinations

πŸŒ€ Add a Portal to Another Topia World

πŸ›Έ Add a Teleport Link
πŸͺ‚ Create Destination URLs
πŸ—„οΈ Add a Toolbar Shortcut
⏰ Add a Timed Event or Activity

Special Zones

πŸ”² Zones

πŸŽ™οΈ Broadcast Podium
🏒 Private Zone

🎀 Broadcasting in Private Zones

🀫 Create a Mute Zone
πŸ”‡ Mute Zone


✏️ Edit Mode

Edit mode allows you to add or modify any asset in a world where you are the owner or an administrator. To turn on Edit Mode, click the Edit toggle on the toolbar. When turned on, the toggle will show a check mark highlighted in teal.


πŸ”Š Add Audio and Video into Your World

Audio

A fun way of livening up your Topia world is by adding music, sounds, or even a livestream to an asset. Whether you want to hear a gentle rainstorm by a stream or a live DJ playing on stage, this can help you set the mood.

Video

From video slideshows to independent short films, adding video is also a great way to make a world more engaging. Embedded videos can be displayed in three different ways:


πŸ“Ί Add Spatial Audio and Video to an Asset

Topia supports pre-recorded and live-streaming media coming from YouTube, Twitch, and Vimeo as well as media files stored on Dropbox and Amazon Simple Storage Service.

Once an asset is placed in a world, you can add media to it by doing the following:

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal.

  • Hover your cursor over the asset and click the pencil icon that appears above it

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Media

  • On the Media page, Select either Audio (Link) or Video (Link). Selecting Audio (Link) will play only the audio portion of the media. Select Video (Link) will show the video as one of the peer video boxes when a guest approaches the asset.

  • Use Audio Volume and Audio Radius to adjust the sound level and the distance you want the sound to cover

  • To sync the audio for everyone, regardless of when they get to the asset, select Sync Media (skip if media is already live-streaming)

  • Add the URL address of the media in the field labeled Media Link by using one of the following methods:

    YouTube & Twitch:

    • Use the complete URL address of the video

    • Use software like OBS Studio to first stream to Twitch or YouTube, and then add the media link from there.

    YouTube Livestream:

    • Use the complete URL address of the video

    • Do not toggle on Sync Media. Doing so will start from live stream from the very beginning for each guest.

    YouTube Playlist:

    • Add the following URL and replace the β€œxxxxxxxxxxxxxxxxxx-xxxxxxxxx” with the unique code found at the very end of the playlist’s share link:

      youtube.com/embed/videoseries?list=xxxxxxxxxxxxxxxxxx-xxxxxxxxx

    Vimeo:

    • On Vimeo, in the top left corner of the video, click the Share icon

    • Copy the text under Embed and paste this into a note or doc. Then grab the URL in first part of the text, located between src=β€œ and " width="640"

      The bolded text in the example below is what the URL will look like:

      <iframe src="https://player.vimeo.com/video/262533093?h=91d1003984" width="640" height="360" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe> <p><a href=...

    • Use this URL as the media link

    • Volume adjustments are not yet available for this media type

    Media on Dropbox (audio only):

    Media in Amazon Simple Storage Service (Amazon S3) (audio only):

    • On Amazon S3 take the file link and change the URL to the following structure:


      https://s3.[REGION].amazonaws.com/[BUCKET_NAME]/[FILE_NAME]

    • Audio volume adjustments are not yet available for this media type

  • If you are adding live video, give the video a name under Video Link Title, this name will appear under the video stream

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer


🎬 Sync Pre-Recorded Media

For media links, you can ensure pre-recorded media is synced across all guests in your world. To enable this, choose the asset playing the media, open the Edit drawer, click Media, and then toggle on Sync Media. This is not necessary for live-streaming content since the media is synced automatically.


πŸŽ₯ Add MP4s to a Video Player Asset

With a paid subscription plan, you can upload your own .mp4 videos into a video player within Topia. To add a video to a video player in your world, follow these simple steps:

  • Open the Topia Assets and filter the results for the category: Video Player

  • Choose a video screen and drop it into your world

  • Once placed, hover your cursor over the asset and click the pencil icon that appears above it

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Media

  • On the Media page, select Video (Uploaded)

  • Use Audio Volume and Audio Radius to adjust the sound level and the distance you want the sound to cover

  • Under Upload Video Media, enter a title for the video, choose the file, and press Upload .mp4. After the upload is complete, the video will start immediately and playback will be synced for everyone

  • To switch to a previously uploaded video, use the toggle in the Uploaded Video Media table

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer


πŸ‘ˆ Create Clickable Assets in Your World

Make your world more engaging with website links, portals, teleporting, and embedded websites, images, or PDFs.

Every asset in your world can become clickable, making your Topia experience more immersive. Clicking on an asset can display text or an uploaded image; open a website (embed or in a new tab), a video, a web hosted image or pdf; let you portal to another Topia world, or teleport to another location within the same world.



πŸ’¬ Display Text

With but the flick of your Topi's wrist-arm-like-appendage, you are able to display custom text when an asset is selected.

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Display text to add text


πŸŒ„ Display An Uploaded Image

Indeed, with but a second wrist flick, you are able to display an uploaded image when an asset is selected.

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Display an Uploaded Image and unleash the power of images when an asset is clicked!


πŸ”— Embed an External Website

Create more engagement by adding a website link to an asset. The link will either open in an embedded iframe within Topia or in another browser tab depending on whether the website allows website embeds.

Follow these simple steps:

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Open a website link

  • Enter the website URL under the Web Link field

  • If you want the link to displayed in a separate tab rather than in an embedded frame, modify the URL by removing the "s" from "https":

    Original URL:

    https://www.example.com/

    Modified URL:

    http://www.example.com/

  • Enter a name in the Web Link Title field. If the website allows embedding, the title will appear at the top of the website embed frame

Check out a few of our favorite external widgets & embeds here!


πŸ“Ί Embed YouTube, Vimeo, or Twitch as an iframe

Once an asset is placed in a world, you can easily make it a clickable object that opens a YouTube, Vimeo, or Twitch video by doing the following:

  • Replace the β€œxxxxxxxxx” with the unique code found at the very end of your video’s url or the name of the Twitch stream

  • Enter a name for the video under Web Link Title. This name will appear at the top of the video

Now, when a guest in the world clicks on the object, an embedded iframe of the video will appear. If the video is live-streaming, it will be synced for all who are viewing it.


πŸ–ΌοΈ Embed an External Image, Document, or PDF

PNGs, JPGs, JPEGs, and WEBP, oh yes! Any asset can open a statically hosted image, document, or PDF when clicked. This can be great for creating an interactive scavenger hunt or for displaying info throughout a world. Guests who then click an asset with an embedded image can view the file in world.

In order to add an image, document, or PDF, the file must have a unique URL. This can be done by uploading the file to: a personal website, Google Drive, Dropbox, Imgur, AWS S3 Bucket, etc. Add the unique URL just as you would add a link to any website:

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Open a website link

  • Enter the website URL under the Web Link field. The link may need to be modified to ensure that it will embed:

    on Google Drive:

    • Ensure share settings are set to Public. Double click on the file or click on Preview to open the file. (Do not use a direct share link, such as the link shown in your browser’s address bar or Google Drive share options.)

    • In the window that opens, click again on More actions in the top right-hand corner (three vertical dots icon) and choose Open in a new window

    • Copy the url that appears in this new window and use this url instead to make the clickable asset show the content in an iframe.

    • In the new window, click again on More actions in the top right-hand corner (three vertical dots icon) and choose Embed item...

    • Copy the url from within the embed script, shown between the ” ” quotation marks

    on DropBox:

    on Imgur (images only):

    • Right click on the image and choose Open Image in New Tab.

    • Use the link from the new tab if it ends with ".png", if instead it ends in ".jpeg" or ".jpg", replace it with ".png".


πŸŒ€ Add a Portal to Another Topia World

Portals are a great way to connect multiple Topia worlds together. They can be used to create private meeting areas or breakout spaces that all link to a main world. You can also create more interactive experiences by adding rabbit holes through other worlds - the possibilities are endless!

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Portal to another world

  • In the field labeled Portal Link, enter the world URL (e.g.: https://topia.io/welcome) or simply add the url slug (e.g. /welcome)

  • If you want the portal to go to a specific location of the world instead of the world spawn point, enter the X: and Y: coordinates of the destination

When a guest in your world clicks on the asset, a pop up will appear asking if the guest wants to travel to another world.


πŸ›Έ Add a Teleport Link

Any asset can be made into a teleporter, allowing guests to transport themselves to another location within your world in just one click.

First, decide where you'd like the teleport to lead to and then find the coordinates of the destination. To find the coordinates, follow these steps:

  • Walk to the desired destination in your world

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over any asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Teleport to another location in this world

  • Write down the X: and Y: coordinates listed at the bottom of the page. (e.g.: Your current position is: X= 1, Y = -29)

Next, add teleport to an asset:

  • Walk to the asset you'd like to transform into a teleporter

  • Hover over any asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page select Teleport to another location in this world

  • Enter the X: and Y: coordinates previously obtained from the destination

Now when a person clicks on the asset, a pop up will appear asking if they want to teleport to that location in the world.

πŸͺ‚ Create Unique Destination URLs

Holding a large event and need multiple entrances to your world? Need a link to sending people directly to your virtual office so you and others don't have to walk there? We've got you covered!

An external link can be made that sends a person to a specific location in a world by using the following url:

topia.io/example?spawnx=xxxx&spawny=xxxx&portal=true

  • Replace 'topia.io/example' with the url of the world

  • Then replace 'xxxx' after 'spawnx=' and 'spawny=' for the X: and Y: coordinates obtained from the destination people are being sent to.


πŸ—„οΈ Embed a Toolbar Shortcut

Easily embed a clickable shortcut to the World Map, Events, Portals, Marketplace, you name it, World Builders. Topia drawers and pages can be opened with the simple click of an asset in your world. This linking option allows you to customize which Topia component your asset should open when clicked.

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Links

  • On the Links page, select Open a Topia application drawer or page

  • Then choose one of the following drawers or pages to open when this asset is clicked:

    • Create World Modal

    • This World Drawer

      β€· World Map

      β€· Events Page

    • Marketplace Drawer

      β€· Marketplace Page

    • Share World

    • Help

    • Discover Worlds

      β€· Discover Public Worlds Page

    • Recent Worlds Page

    • My Worlds Page


⏰ Add a Timed Event or Activity

Hosting an event or series of activities in your world? Add events to the calendar within your world to make it easy for guests to see what's happening and easily navigate to the exact location of the event.

Events in Topia are linked to a specific asset / object within the world.

  • Enter your world

  • Navigate to the location within your world where you will be hosting the event or activity

  • Choose an object to attach the event (you can also place a new asset)

  • Hover over the asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Events

  • On the Events page, enter the following information about your event: title, description, event image, start time and end time. You can also add an event image and choose to link it to the agenda of an existing event

  • If you would like to include the event to Topia’s public event directory, toggle on Make Event Public

  • Click Add Event

πŸ“ See a List of Events

To see a full list of events in your world, click on the Events icon on the bottom of the toolbar. Events will be listed in chronological order based on the start time of the event. Once an event is over, it will no longer appear in the list.

πŸ” FAQs About Topia Events

What happens when the event is over?

When the event is over (after the "end time" has passed) the event will no longer appear in the list of events inside your world.

What happens if I delete the object that the event is attached to?

The event will be deleted when the object is deleted. You can always add a new event to a new object!

How do I delete an event?

Click on the Events icon on the bottom of the toolbar which will open the Events drawer. Click Manage Events, scroll down to find the specific event, and then click Delete Event icon on the right of listing.

What time zone is the event in?

Events will default to the local time zone. When you enter the event, it will sync to the time zone that you are currently in. When guests access your world, they will see the event time in their own time zone.


πŸ”² Zones

Make any placed asset a special zone, and have it become a broadcast podium or a private conversation zone within your world.

πŸŽ™οΈ Broadcast Podium

Turn any asset into a broadcast podium, a zone which will enable broadcast mode automatically when a guest (or designated speaker) is nearby the asset.

Creating a broadcast podium is great for Q&A talks or panel discussions where you may want many different people to be heard by everyone.*

Any asset can be used as a broadcast podium, here's how:

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over any asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Zones

  • Click the toggle under Asset Broadcast. When turned on, the asset will automatically place the first guest that stands on it to Broadcast Near/Zone mode until they walk away from the asset

    • To make the podium automatically place the guest in Broadcast All, click the toggle under Broadcast All to turn it on

    • To have only a specific guest associated with the podium, enter their email under Broadcast By Email. When an email address is entered in the field, only the person designated will enter broadcast mode when they approach the asset. The email address entered must match the email address used to login to Topia

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

    *In free worlds, no more than 2 broadcasts can be done at a time. There is no limit for paid subscription plans.


🏒 Private Zone

Turn any asset into a private zone, creating a space with a capacity cap on the # of people who can enter. When you are in a private zone, only the people in the private zone with you can see and hear your video.

Creating this type of zone is great for having private conversations where you only want a certain number of people to see and hear you at one time

Any asset can be used as a private zone, here's how:

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover over any asset and click the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Zones

  • Click the toggle under Asset Private Zone.

  • Enter the max number of guests allowed in the room under Private Zone Capacity

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

When turned on, the asset will automatically place any guests who stand in this area into a privatized conversation hidden from view until the capacity is reached.

Let guests know where the private zone is located by adding a sign. A Private Zone sign asset is located in the Topia Assets library.

🎀 Broadcasting in Private Zones

When you place a broadcast podium within a private zone and the podium is set to Broadcast-Nearby, guests inside the zone will have the ability to see the broadcaster regardless of their proximity to them. You can have multiple broadcasters in one zone and that zone can be very large with any number of guests. Stepping outside the zone will disconnect the broadcast.


🀫 Create a Mute Zone

Create a silent area within your world where everyone who enters the space is automatically muted when they enter that zone.

Whether you are hosting a lecture, a meditation, or a musical performance -- there are plenty of occasions where you may want to minimize distractions or interruptions by encouraging silence from guests in a specific area of your world.

πŸ”‡ Mute Zone

A Mute Zone is an area that you can designate in a world. When a guest walks into a Mute Zone, their microphone will be automatically muted. Once in the area, the user won’t have the ability to unmute their mic.

A Mute Zone, like media & links, can be attached to an object within your world. Here's how to add a Mute Zone to your world:

  • Make sure Edit Mode is on and the Edit toggle on the toolbar is teal

  • Hover your cursor over the asset and click on the pencil icon

  • Click Edit from the drop down menu to open the Modify Asset drawer

  • Click Zones.

  • On the Zones page, click the toggle under Mute Zone to turn it on.

  • Collapse the page by clicking the β˜β† icon in the top right corner or close the page and drawer by clicking on the βœ• in the drawer

If someone is set to broadcast their audio will not be impacted by the Mute Zone and they will still be heard by others.

Did this answer your question?