• create a github account if you don't have one
• go to this page, and fork the repo
• create a heroku account if you don't have one
• create a new app on heroku
• go to settings, and remove all buildbacks
• create two build backs: first ffmpeg, next nodejs
• go to deploy, and connect the new app to github
• search "doorbell" and choose the repo you've just forked
• wait for the deployment process to finish
• click the "view app" button and copy the url of the new webpage, e.g.
  https://mydoorbell.herokuapp.com/
• replace "https" in the copied url to "ws" or "wss" and remove the trailing slash, e.g.
  wss://mydoorbell.herokuapp.com

• "url" is the url to the doorbell sound, you can upload your own sound clip to altspace
• "duration" is duration of the doorbell sound
• "language" is the accent you want the annoucer to speak in,
  go to this page to see available languages
• "volume" should be within range [0, 100]
• "rolloff" should be greater than 0

this MRE also has the ability to add TTS buttons.

There are two types of text to speech (TTS) buttons:

• Buttons with a pre-defined message, can be used as automatic commentators for galleries, exmaple content pack

 {
 	"buttons": [
 		{
 			"name": "artifact1",
 			"resourceId": "artifact:1579238678213952234",
 			"transform": {
 				"position": {
 					"x": 0, "y": 0, "z": 0
 				},
 				"rotation": {
 					"x": 0, "y": 0, "z": 0
 				}
 			},
 			"dimensions": {
 				"width": 0.1, "height": 0.1, "depth": 0.1
 			},
 			"messages": {
 				"en-us": "Hi, this is the message for artifact 1"
 			}
 		}
 	]
 }

• On-demand TTS, it will read out the message you typed

 {
 	"buttons": [
 		{
 			"name": "ondemand",
 			"ondemand": true,
 			"resourceId": "artifact:1579238678213952234",
 			"transform": {
 				"position": {
 					"x": -1, "y": 0, "z": 0
 				},
 				"rotation": {
 					"x": 0, "y": 0, "z": 0
 				}
 			},
 			"dimensions": {
 				"width": 0.1, "height": 0.1, "depth": 0.1
 			}
 		}
 	]
 }

• definitions:
  • "resourceId" is the artifactId of kit object the button
  • "transform" is the unity transform of the button including position, rotation and scale
  • "dimensions" is the dimensions of the collider of the button
  • if "ondemand" is true, the button is a On-demand TTS button

• "layout" defines the number of rows and columns of the soundboard
• "sounds" includes information of the sound clips
  • "uri" is the url to the sound clip
  • "name" is the text displayed on sound board button
  • "duration" is the duration of the sound clip
  • "volume" should be within range [0, 100]
  • "rolloff" should be greater than 0