Sansar Docs
  • 🚀Welcome to Sansar
  • 📚GLOSSARY
  • 🎏Patch Notes
  • 😇Work in Progress
  • ⚠️Creative Commons License
  • Support
    • General Troubleshooting
      • General FAQ
      • The Sansar Cache
      • The Sansar Log
    • Contact Support
  • Sansar Basics
    • Installation And Compatibility
      • Installing Sansar
      • System Requirements
      • Sansar Compatibility FAQ
      • Sansar on Mac
      • Body Tracking Vive
      • Configuring Firewalls
    • Account Management
      • Account Set Up
      • Avatar Name and ID
      • Adding Payment Method
      • Discord FAQ
      • Steam Integration
      • Subscription FAQ
    • Controls
      • Avatar Hand Gestures in VR
      • FreeCam and CineCam
      • Game Controller Buttons
      • HTC VIVE controls
      • Keyboard Shortcuts for Editing a Scene
      • Keyboard Shortcuts for Styling Your Avatar
      • Keyboard Shortcuts for Visiting an Experience
      • Mouselook Mode
      • Oculus Rift Controls
      • Vive Index Controls
    • Settings
      • General Settings
    • VR Settings
      • VR Settings Menu
      • Calibrating Height in VR
  • Exploring in Sansar
    • Navigate and Explore
      • The Codex
      • Instances
      • Interactive objects
      • The Main Menu
      • The Nexus
      • Portals
      • Quests
      • Quick Start: Exploring in Sansar
    • Socialize And Connect
      • Chat Panel
      • Experience Points, Levels, and Titles.
      • Finding People in Sansar
      • Identifying Interacting With Avatars
      • The People panel
      • User profiles
    • Attending events
      • Deploying Unpublished Event to Event World
      • Adding Events to Your Calendar
      • Attending Events in Sansar
      • Avatar Broadcasting FAQ
      • Creating Your Own Events
      • Redemption Codes
      • Tipping
    • Share Content
      • Streaming Sansar
      • Taking a photo
  • Avatar Creation
    • Avatar Basics
      • Avatar 2.0 FAQ
      • Customizing Your Avatar
      • Avatar Emotes
      • The Avatar Editor
    • Dressing The Avatar
      • Fitting Designer Clothing to your Avatar
      • Setting Custom Emotes
      • Wearing Accessories
      • Wearing Rigged Clothing
    • Managing Avatar Items
      • Importing Avatar-Related Items
      • Editing an inventory item's name
      • Editing an inventory item's image
      • Deleting avatar looks from your inventory
      • Importing a custom emote animation
      • Managing your avatar looks inventory items
    • Avatar Resources
      • Avatar Reference Files
      • Blender - Avatar files
      • Blender - Using Decimate Tool
      • Exporting Custom Avatars From Blender
      • Sansar Skeleton Skinning Details
      • Using Animation Skeleton
  • Creating In Sansar
    • Importing Things to Sansar
      • Supported file types
      • AABB Bounding Box and Item Restrictions
      • Importing Audio
      • Importing a Custom Avatar
      • Importing World Items
      • Importing Collision Volumes
      • Importing Accessories
      • Importing Clothing
      • Importing Emotes
      • Importing Hair
      • Importing Custom Scripts
      • Importing a Skybox
      • Troubleshooting Import Errors
    • Shaders and Materials
      • Shaders Information
      • Materials Information
      • VAT Shader Guides
        • VAT Shader Basics
        • VAT Technical Info
      • Displacement Guides
        • Simple Displacement
        • Advanced Displacement
    • Marvelous Designer Info
      • Marvelous Designer Integration
      • Marvelous Designer Creator Resources
      • Marvelous Import and Export
      • MD Limitations
    • Shader Scripting
    • Materials editing and shaders
    • Creator Tools
      • Creating a World
      • Creating Quests
      • Diagnostics Toolbar
      • Importing Items to Sansar
      • My Worlds Panel
    • Managing Worlds
      • Quick start: Creating experiences in Sansar
      • Deleting an experience or scene
      • Deploying a new scene to an existing experience
      • Editing a scene
      • Experience memos
      • Linking A Scene To A World
      • Managing your scenes and worlds
      • Moderation Tools for World Owners
      • Publishing Options for Your Experiences
      • Renaming a scene
      • Saving and Building A Scene
      • Sharing Your Experiences
      • Visiting your own experience
    • Part Of The World Editor
      • Object Stats Toolbar
      • Object Components
      • Parenting objects
      • Scene Item Inventory
      • Scene Objects Panel
      • Collision Volumes
      • Scene Settings
      • System objects
      • Object Motion Types
    • Working With Scripts
      • Working With Scripts
      • Working With Trigger Volume
      • Referencing Scene Components
      • Intro to Scripting in Sansar
      • Using the Script Console
      • Setting Script Parameters
      • Adding Scripts to an Object
      • Configuring Teleport Scripts
      • Simple Script User Guide
    • Working With Audio and Video
      • Working With Audio
      • Creating Media surface
      • Streaming Web Audio
      • Audio Emitter
      • Sansar Audio FAQ
      • Using Media Streams
      • Ambisonic Sounds
      • High Quality Spacial Audio
      • Audio Resource - Room Tones
      • Previewing Audio and Video in a Scene
      • Using Audio Materials
    • Working With Lights
      • Working With Lights
      • Light Types
      • Global Illumination
  • Sansar Store
    • Using the Sansar Store
      • The Sansar Store
      • Buying Items From The Store
      • Redelivering Lost Purchases
    • Buying and Selling Sansar Dollars
      • Gifting Sansar Dollars
      • Buying Sansar Dollars
      • Converting Sansar Dollars
      • Processing US Dollar Credit
    • Selling Your Content
      • Hidden Store Listings
      • Selling Items in Sansar Store
      • Selling Items in an Experience
      • Allowing Resale Of Items
      • Buyers Permissions
  • Guidelines and Moderation
    • Guidelines and Policies
      • Terms of service
      • Sansar's Discord Server Rules
      • Community Standards
      • Content Guidelines
      • World Publishing Guidelines
      • Store Listing Guidelines
      • Store Banner Guidelines
      • Event Guidelines
      • Privacy Policy
      • Sansar Freeware License Agreement
      • Intellectual Property Infringement Notification
      • Cookie Policy
    • Moderation and Reporting
      • Abuse and Griefing
      • Blocking Avatars
      • Muting Avatars
      • Reporting abuse
      • Reporting issues and bugs
      • Security issues
  • Script API Docs
    • General Information
      • External Script Repository's
      • Sansar Script API
      • Script API Updates
      • Restricted API's
    • Example Scripts
      • Example Scripts in Sansar
      • Cannonball
      • Follow The Path
      • Random Movement
      • Reflective Detector
      • Simple Script
      • Sound Randomizer
      • Stats Example
      • Teleport Hotkeys
      • Visitor Tracker
      • Mover Examples
    • Sansar Namespace
      • Namespace
      • Color
      • Mathf
      • Quarterion
      • Vector
      • Vector Extensions
    • Sansar.Script Namespace
      • AddEntryAttribute
      • CancelData
      • ComponentID
      • CoroutineException
      • Default Attributes
      • Editor Visible Attribute
      • Entries Attribute
      • Event Data
      • ICoroutine
      • IEvent Subscription
      • Instance Interface
      • Locked Attribute
      • Log
      • MaxEntriesAttribute
      • Memory
      • MinEntriesAttribute
      • NonReflectiveAttribute
      • ObjectID
      • OperationCompleteEvent
      • RangeAttribute
      • Reflective
      • Script.Base
      • Script Event Data
      • Script Handle
      • ScriptID
      • SessionID
      • Simple Script Event Data
      • ThrottleException
      • Timer
      • Tooltip Attribute
    • MetaData Namespace
      • Assembly MetaData
      • Script MetaData
    • Sansar Script Testing Namespace
      • Assertion Failure Exception
      • Assertions
    • Sansar Utility Namespace
      • GenericEnumerable <T>
      • GenericEnumerable<T>.GetItem
      • JSON Serialization Data
      • JSON Serialization Data 1
      • JSON Serializer
      • JSON Serializer Options
    • Sansar Simulation Namespace
      • Agent Info
      • Animation
      • Audio Component
      • Camera Control Mode
      • Character Tracker
      • Chat
      • Client
      • Cluster
      • Command Action and Data
      • Component Type
      • Control Point Type
      • Held Object
      • HTTP
      • Interaction
      • Light
      • Media Action
      • Mesh Component
      • Modal Dialogue
      • Move Mode and Mover
      • Objective
      • PlayHandle
      • PlaySettings
      • PlayStatus
      • Quest
      • RayCastHit
      • Rigid Body
      • Scene
      • Scene Public
      • Simple Script
      • Sit Event Type
      • Sit Object Data
      • Sound Resource
      • Stream Channel
      • Tutorial Hint
      • UI
      • User Data
Powered by GitBook
On this page
  1. Creating In Sansar
  2. Working With Audio and Video

Audio Emitter

PreviousStreaming Web AudioNextSansar Audio FAQ

Last updated 1 month ago

The Audio Emitter

An Audio Emitter is an object that can be placed in a scene and plays a sound. You can drag a sound into a scene and attach it to an audio emitter that is spatialized, meaning the sound originates from the location of the emitter.

To add an audio emitter to a scene:

  1. While editing a scene, look at the Inventory panel at the bottom of the interface.

  2. Set the filters to System > Audio > Newest

    Filter for System objects of the type Audio.

  3. Drag the Audio Emitter icon from the inventory to your scene.

  4. Click the audio emitter and click the Properties button to see the following sound settings:

  • Position - An audio emitter can be positioned just like any other object, so you can control where a sound is coming from. You can also attach a or to the object and the sound moves where the object moves.

  • Rotation - This rotates the soundfield orientation for stereo and sounds, which is useful if you want to match an emitter with corresponding visuals around it. It does not affect mono sounds.

  • Sound Source - Choose between two sources for your sound:

    • Inventory - Choose this if you want to use a sound from your inventory. If chosen, a Sound dropdown appears under Sound Source.

    • Stream - Choose this if you want to stream music from live radio stations such as Shoutcast, Icecast, and other services using MP3 and more compatible formats. For more information, see . If chosen, you may choose a web audio stream or media stream from the dropdown. See for more information on setting the audio and media streams.

  • Sound - Only available if the Sound Source chosen is Inventory. Choose a sound you have uploaded to your Inventory. The dropdown lists all audio files that are currently in your inventory. If is on, the sound plays when you select it.

  • Stream - Only available if the Sound Source chosen is Stream. Choose a web audio stream or media stream from the dropdown. See for more information on setting the audio and media streams. If is on, the current Stream URL plays. If it's silent and Loudness is at a reasonable level, it might mean that the stream URL is down or invalid.

    Note**:** If the Sound Source is set to Stream, one of the options you may choose as the Background Stream is Voice Broadcast, which broadcasts the voice chat of designated avatars from the audio emitter. At this time, avatars may only be designated for broadcasting by using a script that uses the .

  • Loudness - Use the slider, or enter a value to set the relative volume level of the sound. Set your loudness based on either Level or dB values by toggling the dropdown. A new emitter has a reasonable default Loudness.

    • Level values - For audio newcomers. Use the slider, or enter a value to set the relative volume level of the sound using values between 0 to 100. Loudness becomes softer the closer the value is to 0, and becomes louder the closer the value is to 100.

    • dB values - For experienced audio users used to working with decibel gain. Use the slider, or enter a value to set the relative volume level of the sound in decibels. 0 dB is the base gain of the sound after -3 dB peak auto-normalization has been applied during upload. This means sounds that you upload into Sansar may be relatively louder than before.

  • Emitter Shape - Choose between a point emitter or a volumetric emitter (also known as an audio volume) if you want a sound to fill a bigger or smaller area. Choose from the following:

    • Point - A point emitter is appropriate for smaller, focused sounds that originate from a specific coordinate.

    • Cuboid - A volumetric emitter, shown as a green box. Cuboid Size controls how far the sound goes before falling off. Enter XYZ values to change the sound shape. A typical use of a cuboid is filling a larger space with ambient sound, whether that is a room in a building or an outdoors environment. For example, a field of crickets at night.

    • Sphere - A volumetric emitter, shown as a green ball. Similar to the cuboid type, you can specify a Sphere Radius that determines how much area the sound fills before falling off. A sphere is useful to fill curved spaces where a cuboid may feel unnatural.

Sound properties for a Point emitter with Inventory selected as the sound source.

Note: You may not hear much apparent difference at higher loudness level when using sounds that are inherently very loud (such as a distorted guitar or an airhorn), especially when other loud sounds are playing nearby. Sansar's audio engine attenuates the overall audio output to prevent hearing damage. Especially when working with multiple sound sources, it's best to err on the quieter side since emitter loudnesses add up, which is why the default Loudness is set at a conservative value. See the explanation below.

It is possible to overlap emitters for layered sounds, and we encourage doing so for more detailed soundscapes. For example, if you're building a forest next to a beach, you can use different volumetric emitters for these zones that slightly overlap, so you hear a gradual transition from birdsong in the forest to waves lapping on the beach. To take this even further, you might even have staggered emitters with different wave loops of different lengths playing, reducing repetitiveness and increasing the variety you can hear while walking down the sandy shores.

We recommend that you lower audio levels of sounds that you want less emphasis on, instead of only raising the levels of sounds you want to stand out. This is known as "subtractive mixing", and results in a clearer soundscape. We also recommend testing voice chat in your scene. Unless the intention of your scene is to discourage voice chat (like how it's hard to hear others in a realistic nightclub), you should be able to clearly speak with others at a normal level without feeling you have to shout — think about your visitors!

We recommend enabling to hear sounds when in the layout editor, and enable to enhance the immersiveness of your spatial audio.

Note: Sansar has HDR (High Dynamic Range) audio with a window of 36 dB — that's the range from the quietest to the loudest sounds you can hear. Loud sounds automatically "" quieter sounds, enabling loud sounds to be heard more clearly. However, if too many loud sounds are playing at once, it sounds muddy and unpleasant because they are all fighting for attention. Another reason why we have implemented it this way is to prevent hearing damage from sustained loud sounds, or even transient "spikes" that may be startling and painful to your ears.

To calibrate your scene's general volume levels, visit our , which transitions from fairly prominent music inside the dome, to a more subtle soundscape on the outer walkway. Keep walking around the circle and pay attention to different sounds. There's gentle background ambience, but also "spot focus" sounds that are more prominent in the foreground. This should give you a better idea of how dynamic range sounds in action.

Have more questions? Ask in our

duck
Origin 360 Cinema
Discord!
sound
audio stream
ambisonic
Web audio streams
using and previewing media streams
Audio Preview
using and previewing media streams
Audio Preview
ScenePrivate class of the Sansar Script API
Audio Preview
Compute Reverb