All pages
Powered by GitBook
1 of 11

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Oculus Controls

Left Controller

  • Thumbstick: Rotation

  • Trigger: Teleport / Mouse jump

Right Controller

  • Thumbstick: Movement

  • Trigger: Click within the experience

Avatars

Avatars are the digital representation of actual people (humans... for now).

When you enter the metaverse, you enter as your Avatar. You also see other people as their avatars.

Behind every Avatar is an actual person

How do I create my Avatar?

The following instructions apply when you view a . If you are trying to first create an experience (to deploy), check the and sections.

Ready Player Me

If you wish to create an Avatar using Ready Player Me, select the option 'Ready Player Me' and you will be redirected to the following screen. Here, you can make your selection based on your preferences.

You have the option to take a picture, select a file from your computer, or continue without a photo to generate your Avatar.

After selecting your preferred option, follow the subsequent steps to create your Avatar.

Here is an example of a Ready Player Me Avatar generated after selecting the 'Continue without a photo' option.

GMetri Avatars

Also Read

Viewing

To view a GMetri experience, generally, you just need to click the that was shared with you.

Experiences may also be - in that case, it should automatically load when you open the web page.

If instead you were given an app or an LMS page - you can contact the admin in your organization to get details of how to run the experience.

Running the experience on your Phone or Desktop

Whitelisting for Analytics

If you are unable to view Analytics on GMetri on certain networks, which is commonly the case on corporate and university networks, it may be required to whitelist GMetri's servers and ports so that they are not blocked by the firewall.

Essential

These domains cover the bare minimum domains that need to be whitelisted for any GMetri experience to run.

  1. *.gmetri.com

  • *.vrgmetri.com

  • Non Wildcard List

    (In case you aren't able to use the wildcard entries above)

    1. portal.gmetri.com

    2. d.vrgmetri.com

    3. s.vrgmetri.com

    4. u.vrgmetri.com

    5. sms-api.bknd.gmetri.com

    6. z5api-editor.bknd.gmetri.com

    7. z5api-analytics.bknd.gmetri.com

    IT Permissions

    Network Whitelisting

    Whitelisting for Viewing ExperiencesWhitelisting for Editing Experiences
    GMetri deployment link
    Building
    Avatar System
    Avatar System
    Basic + Ready Player Me Avatar System
    Ready Me Player - Create your Avatar
    Ready Me Player 2 - Create your Avatar
    Example Avatar
    Basic Only Avatar System
    Concurrency

    Open the default browser on your phone (Ensure its one of these browsers)

  • Type the deployment link that you want to open as the URL and load the page

  • Running the experience on a Headset

    To open a GMetri experience on a headset, open the deployment link in the Headset's default browser, and click the "Enter VR Mode" button that pops up.

    Example

    Here is a GMetri experience embedded in this webpage:

    You can also access the same experience by clicking on this link.

    Internet Speeds

    If you are experiencing connection issues when joining a GMetri Experience, the first step is to do a Speed Test

    The faster your speeds are, the better your GMetri experience will be.

    • For the best experience: 50Mbps download, 10Mbps upload

    • Minimum requirements: 20Mbps download, 2Mbps upload

    deployment link
    embedded in a webpage

    Concurrency

    Without , how many people can be in the same scene at the same time?

    Unlimited.

    There's virtually no limit to the number of people you can get in these deployments. However, we would recommend in case you are planning to host an event with >50,000 concurrent users.

    Whitelisting for Editing Experiences

    If you are unable to view Experiences on GMetri on certain networks, which is commonly the case on corporate and university networks, it may be required to whitelist GMetri's servers and ports so that they are not blocked by the firewall.

    Essential

    These domains cover the bare minimum domains that need to be whitelisted for any GMetri experience to run.

    1. *.gmetri.com

    Viewer Keyboard Shortcuts

    Keyboard Shortcuts for the viewer

    Action
    Windows/Linux Shortcut
    MacOS Shortcut
  • *.vrgmetri.com

  • *.s3.amazonaws.com For uploading files from the editor

  • Recommended

    In addition to the above list, you will need to additionally whitelist the below domains

    1. *.paddle.com Subscription and Billing management

    2. *.flickr.com, *.staticflickr.com Integration with Flickr

    3. *.sketchfab.com Integration with Sketchfab

    4. *.googleapi.com, developers.google.com, *.google.com, *.gstatic.com Maps, location-based analytics

    We use ReadyPlayerMe as our 3D avatar provider. Users can log in to their own RPM account and import their avatars into GMetri, our create a new one as guests.

    1. readyplayer.me

    2. cname.vercel-dns.com

    3. avatars.readyplayer.me

    4. d1a370nemizbjq.cloudfront.net

    Optional Services

    We use a number of services to keep GMetri systems functional and support advanced features.

    Google SSO / Location Tracking (Optional)

    These are required for Google SSO and location tracking. These are optional but are required is you're looking to use Social and Google Auth for your GMetri Experiences

    1. *.googleapis.com

    2. developers.google.com

    Help / Support (Optional)

    These are required for any remote debugging issues at the user's end. We use Trackjs to collect any errors reported on users' devices and Calendly to book meetings.

    1. *.trackjs.com

    2. calendly.com

    e

    Emojis

    1, 2, 3, 4, 5, 6

    1, 2, 3, 4, 5, 6

    3D Scene Controls

    The following keyboard shortcuts work only in a 3D Scene

    Action
    Shortcut

    Move

    ←, ↑, ↓, → OR w, a, s, d

    Jump

    space

    Also Check

    3rd Person <-> 1st Person mode

    ctrl + 1

    cmd + 1

    Non-pointer lock <-> Pointer lock mode

    ctrl + 2

    cmd + 2

    Mute

    e

    Editor Keyboard Shortcuts

    In non-multiplayer deployments, multiple people in the same scene don't see each other

    With Multiplayer Mode, how many people can be in the same scene at the same time?

    100 people in the same scene. Upto 100,000 with room instancing.

    In multiplayer deployments, you can see each other, and interact with each other.

    In a single scene, you can have maximum of 100 people at a time.

    You can circumvent this limit, and support up to 100,000 people per room by using Room Limits. You can create copies of room (upto 1000 copies) and allow max 100 people per instance of the room - allowing a total of 100 x 1000 = 100,000 people in the same deployment link.

    Room Limits

    Room Capacity is the maximum number of people can enter the same scene at a time.

    If you get more than say the Room Capacity number of people in a room, we create another replica (instance) of the scene (or room), and the next person enter this new room copy (or instance). You can control these limits from the "Room Limits" tab.

    Room Instancing Options

    Room Limits
    • Room Capacity (max 100): Maximum number of viewers allowed in one scene instance (or room instance)

    • Number of Instances (max 1000): Maximum number of scene replicas that can be created

    • Overspill Message: If there are already (room capacity x number of instances) number of people in a scene, when the next person enters the scene - they see this message.

    When someone enters the scene after it reaches its max capacity, the viewer can still explore the space in non-multiplayer mode

    Issue when you have too many people in the same room in Multiplayer experiences

    In Multiplayer mode, when you have too many people trying to access the same link at the same time, it results in two problems:

    1. Bandwidth: Slower speeds for everyone involved. This is because each device has to share the link's bandwidth with all of the other devices.

    2. Spatial: how many people can you fit in a room? If you put 50 people in a room, all you would see are other people bumping into each other.

    Multiplayer Mode
    let us know

    Subprocessors

    GMetri is hosted on GCP (Google Cloud Platform) in Mumbai (IND) and Los Angeles(US). The application requests automatically get routed based on the geographical location of the end user.

    Processor Full Name
    Processor Country
    Processing Activity
    Types of data processed
    Personal data processed
    Encrpytion

    Google

    Data processed and stored in US

    SSO and Auth

    User ID, Email, Password (hashed), OAuth tokens, Name, Auth provider profile (i.e. name/email/picture from Google. Depends on provider), Phone Number, Geolocation (Only if enabled)

    Only if enabled, All users

    HTTPS, TLS1.2

    Azure

    Data processed and stored in US

    SSO and Auth

    User ID, Email, Password (hashed), OAuth tokens, Name, Auth provider profile (i.e. name/email/picture from Google. Depends on provider), Phone Number

    Only if enabled, All users

    HTTPS, TLS1.2

    Google Cloud SQL

    Data processed and stored in Asia Pacific (Mumbai)

    Main Database

    User ID, Email, Name, Org Name, Device IDs (i.e ID/name from Meta Quest device), Auth provider profile, Geolocation

    All users, always

    HTTPS, TLS1.2

    Agora

    Data processed and stored in US

    Multiplayer Features like video calls, voice calls, chat and screen-sharing

    Audio and video data of the user during a call, Media server logs generated by the Agora servers

    Only if enabled, All users

    HTTPS, TLS1.2, WSS, UDP (Secure Websocket)

    AWS S3

    Data processed and stored in Asia Pacific (Mumbai)

    File Uploads

    File Uploads from GMetri Editor

    Only if using GMetri Editor, All users

    HTTPS, TLS1.2

    TrackJS

    Data processed and stored in US

    Usage Analytics, Error reporting

    User ID, IP Address, Usage Stats, Geolocation

    All users, always

    HTTPS, TLS1.2

    Whitelisting for Viewing Experiences

    If you are unable to view Experiences on GMetri on certain networks, which is sometimes the case on corporate and university networks, it may be required to whitelist GMetri's servers and ports so that they are not blocked by the firewall.

    Essential

    These domains cover the bare minimum domains that need to be whitelisted for any GMetri experience to run.

    1. *.gmetri.com

    2. *.vrgmetri.com

    Non Wildcard List

    (In case you aren't able to use the wildcard entries above)

    1. <DeploymentDomain>.gmetri.com

    2. view.gmetri.com

    3. d.vrgmetri.com

    4. s.vrgmetri.com

    Optional Services

    We use a number of services to keep GMetri systems functional and support advanced features.

    Optional - Realtime Avatar Creation

    We use ReadyPlayerMe as our 3D avatar provider. Users can log in to their own RPM account and import their avatars into GMetri, our create a new one as guests.

    1. readyplayer.me

    2. cname.vercel-dns.com

    3. avatars.readyplayer.me

    Optional - Multiplayer

    In case the wildcard domain *.gmetri.com above wasn't whitelisted, the following GMetri hostname needs to be whitelisted for multiplayer features to work.

    1. multiplayer-socket-viewer.us.gmetri.com

    2. multiplayer-socket-viewer.in.gmetri.com

    In addition to this, we use as our service provider for all Multiplayer and Collaborative features. This is a must if you intend to use Multiplayer/Collaborative features such as Voice calls, Video calls, Screen-share, and Chat.

    1. *.agora.io

    2. *.edge.agora.io

    3. *.sd-rtn.com

    4. *.edge.sd-rtn.com

    Additionally, you may also need to expose certain ports on your network if there are any restrictions added to the firewall

    Destination ports
    Port type

    Optional - Google SSO / Location Tracking

    These are required for Google SSO and location tracking. These are optional but are required is you're looking to use Social and Google Auth for your GMetri Experiences

    1. *.googleapis.com

    2. developers.google.com

    Optional - Help / Support

    These are required for any remote debugging issues at the user's end. We use Trackjs to collect any errors reported on users' devices.

    1. *.trackjs.com

  • u.vrgmetri.com

  • api.vrgmetri.com

  • z5api-viewer.bknd.gmetri.com

  • sms-api.bknd.gmetri.com

  • d1a370nemizbjq.cloudfront.net
  • web-1.ap.sd-rtn.com

  • web-2.ap.sd-rtn.com

  • ap-web-1.agora.io

  • ap-web-2.agora.io

  • webcollector-rtm.agora.io

  • logservice-rtm.agora.io

  • rtm.statscollector.sd-rtn.com

  • rtm.logservice.sd-rtn.com

  • 80; 443; 3433; 4700 - 5000; 5668; 5669; 6080; 6443; 8667; 9591; 9593; 9601; 9667; 30011 - 30013 (for RTMP converter)

    TCP

    3478; 4700 - 5000

    UDP

    Agora
    GMetri Experience Example

    First/Third Person

    First Person vs Third Person

    First Person

    First person refers to the perspective or point of view of the user or player who is interacting with any experience.

    First Person view

    Third Person

    Third person perspective refers to a view of the experience in which the user or player sees their avatar from an external viewpoint, rather than experiencing it from within.

    You can navigate into any 3D scene by using

    viewer keyboard shortcuts
    Third person view