Space Embeds:

This document steps you through the process of embedding a space viewer in a web page.  For example, you might use this to include a personal online space in the context of your blog.  You might also include a space viewer on the web page for a conference so that remote participants can interact with each other while listening to the live audio stream.

If you haven't skimmed the Core Concepts page, now would be a good time to do so.

Find your space ID:

This document assumes that you have a space you've created, either on your own server or on a space hosting service, and that you know the space ID number for that space.  You can find that number either on your account page where it lists your spaces, or you can usually find it in the spaceID parameter of the URL to the space editing or viewing page.  

For our example, we're using space ID # 1.

Locate your spaceEmbed.html file:

This file has the code necessary to view a space.  It usually resides at a URL like http://SOMEDOMAIN.com/og/spaceEmbed.html  You'll know you've found it if you see the following message at the top of the page: "There was an error. This page doesn't specify a space."  Remember the URL to the spaceEmbed.html file.

Edit your target page:

Now paste this little bit of HTML into the page where you want to see your space viewer:

<iframe src="http://SOMEDOMAIN.com/og/spaceEmbed.html?spaceID=1&width=400&height=600" style="margin: 0px; padding: 0px; border: none; width: 400px; height: 600px;" scrolling="no"></iframe>

You'll need to replace the first part of the src attribute with the path to your spaceEmbed.html.

Now save and then open your page in a web browser to see the space.  You can quit now if you're happy with the size and settings of the embedded space viewer, but below are more options.

Edit the URL parameters:

The following parameters can be added to the spaceEmbed.html URL  (like width and height in the example above) to change the default options:

width and height: 

the size of the viewer in pixels

showChat: "true" or "false" 

determines whether to show the text chat

autoGuest: "true" or "false" 

determines whether to prompt people before entering a public space as a guest

movable: "true" or "false" 

determines whether the camera (the user's point of view) can be moved

startX startY and startZ: 

determines the user's position in meters relative to the origin when entering the space

startRX startRY and startRZ: 

determines the user's rotation in radians along the X, Y, and Z axis when entering the space