Recipe: 3rd Party Integrations
Your hub includes integrations for searching useful content for visitors to spawn into their rooms using the Media Browser. There is built-in support for a variety of sites and search engines, such as Sketchfab. You can also tweet to share content directly from your hub.
However, before these various content tabs will be enabled for your hub, you will need to add the necessary API keys to enable the integrations.
In the Admin Console choose Server Settings:
There you will find under API Keys the following keys you can set to enable these features:
Create a Sketchfab account and then Find your API Token.
Sign up for the Tenor GIF API to get a free API key.
Videos & Images
Create a Azure Cognitive Services account and enable the Bing Video Search API and Bing Image Search API.
Sign up for an Azure account at portal.azure.com.
Once signed into Azure, search the services available and create a new Cognitive Services offering. You will need to specify a region and application group to deploy to.
When your service has finished spinning up, navigate to the API keys tab.
Copy one of your API keys from the Azure portal.
In your Hubs Cloud admin panel, navigate to the ‘Server Configuration’ panel and open the ‘API keys’ tab.
Paste the Cognitive Services API key into the ‘Bing Search’ text input.
Save your changes to deploy the video/image search to your Hubs Cloud media browser.
Note: these APIs are not free above 1000 transactions per month. You will be charged for their usage by your Hubs Cloud instance in your Azure account.
Sign up as a Twitch Developer and Get a Client ID.
Enable visitors to tweet out videos and photos they've taken.
Sign up as a Twitter Developer and create an application to generate your keys and tokens. You'll need Consumer keys (API Key and Secret) and Authentication Tokens (Access Tokens and Secret). In App permissions, you'll need Read and Write permissions. Under Authentication settings, enable 3-legged OAuth and add Callback URLs
https://your-hubs-cloud-domain/api/v1/oauth/twitter. Then add your
https://your-hubs-cloud-domain to the Website URL. Request email address from users should be disabled.
Once you've added your consumer/access tokens and secrets into the Admin Panel > Server settings menu > API Keys, go to a room (with spawning objects enabled), take a picture with the camera, hover over the photo, and click "Tweet".
Congrats! You've enabled Twitter on your Hubs Cloud instance!
Analytics and Error Logging
Add Google Analytics tracking IDs and Sentry DSNs to enable aggregated page tracking and error reporting. Note that full URLs which include room, avatar, and scene identifiers will not be sent to analytics services.