Class HiFiAudioAPIData

constructor

• new HiFiAudioAPIData(__namedParameters?: { hiFiGain?: number; orientationEuler?: OrientationEuler3D; orientationQuat?: OrientationQuat3D; position?: Point3D; userAttenuation?: number; userRolloff?: number; volumeThreshold?: number }): HiFiAudioAPIData

• Parameters

  • __namedParameters: { hiFiGain?: number; orientationEuler?: OrientationEuler3D; orientationQuat?: OrientationQuat3D; position?: Point3D; userAttenuation?: number; userRolloff?: number; volumeThreshold?: number } = ...

    • Optional hiFiGain?: number

      This value affects how loud User A will sound to User B at a given distance in 3D space. This value also affects the distance at which User A can be heard in 3D space. Higher values for User A means that User A will sound louder to other users around User A, and it also means that User A will be audible from a greater distance. If you don't supply an hiFiGain when constructing instantiations of this class, hiFiGain will be null.

      ✔ The client sends hiFiGain data to the server when _transmitHiFiAudioAPIDataToServer() is called.

      ✔ The server sends hiFiGain data to all clients connected to a server during "peer updates".

    • Optional orientationEuler?: OrientationEuler3D

      If you don't supply an orientationEuler when constructing instantiations of this class, orientationEuler will be null.

      ✔ The client sends orientationEuler data to the server when _transmitHiFiAudioAPIDataToServer() is called.

      ✔ The server sends orientationEuler data to all clients connected to a server during "peer updates".

    • Optional orientationQuat?: OrientationQuat3D

      If you don't supply an orientationQuat when constructing instantiations of this class, orientationQuat will be null.

      ✔ The client sends orientationQuat data to the server when _transmitHiFiAudioAPIDataToServer() is called.

      ✔ The server sends orientationQuat data to all clients connected to a server during "peer updates".

    • Optional position?: Point3D

      If you don't supply a position when constructing instantiations of this class, position will be null.

      ✔ The client sends position data to the server when _transmitHiFiAudioAPIDataToServer() is called.

      ✔ The server sends position data to all clients connected to a server during "peer updates".

    • Optional userAttenuation?: number

      This value affects how far a user's sound will travel in 3D space, without affecting the user's loudness. By default, there is a global attenuation value (set for a given space) that applies to all users in a space. This default space attenuation is usually 0.5, which represents a reasonable approximation of a real-world fall-off in sound over distance. Lower numbers represent less attenuation (i.e. sound travels farther); higher numbers represent more attenuation (i.e. sound drops off more quickly).

      When setting this value for an individual user, the following holds:

      • Positive numbers should be between 0 and 1, and they represent a logarithmic attenuation. This range is recommended, as it is more natural sounding. Smaller numbers represent less attenuation, so a number such as 0.2 can be used to make a particular user's audio travel farther than other users', for instance in "amplified" concert type settings. Similarly, an extremely small non-zero number (e.g. 0.00001) can be used to effectively turn off attenuation for a given user within a reasonably sized space, resulting in a "broadcast mode" where the user can be heard throughout most of the space regardless of their location relative to other users. (Note: The actual value "0" is used internally to represent the default; for setting minimal attenuation, small non-zero numbers should be used instead. See also "userRolloff" below.)
      • Negative attenuation numbers are used to represent linear attenuation, and are a somewhat artificial, non-real-world concept. However, this setting can be used as a blunt tool to easily test attenuation, and tune it aggressively in extreme circumstances. When using linear attenuation, the setting is the distance in meters at which the audio becomes totally inaudible.

      If you don't supply an userAttenuation when constructing instantiations of this class, userAttenuation will be null and the default will be used.

      ✔ The client sends userAttenuation data to the server when _transmitHiFiAudioAPIDataToServer() is called.

      ❌ The server never sends userAttenuation data.

    • Optional userRolloff?: number

      This value represents the progressive high frequency roll-off in meters, a measure of how the higher frequencies in a user's sound are dampened as the user gets further away. By default, there is a global roll-off value (set for a given space), currently 16 meters, which applies to all users in a space. This value represents the distance for a 1kHz rolloff. Values in the range of 12 to 32 meters provide a more "enclosed" sound, in which high frequencies tend to be dampened over distance as they are in the real world. Generally changes to roll-off values should be made for the entire space rather than for individual users, but extremely high values (e.g. 99999) should be used in combination with "broadcast mode"-style userAttenuation settings to cause the broadcasted voice to sound crisp and "up close" even at very large distances.

      If you don't supply an userRolloff when constructing instantiations of this class, userRolloff will be null.

      ✔ The client sends userRolloff data to the server when _transmitHiFiAudioAPIDataToServer() is called.

      ❌ The server never sends userRolloff data.

    • Optional volumeThreshold?: number

      A volume level below this value is considered background noise and will be smoothly gated off. The floating point value is specified in dBFS (decibels relative to full scale) with values between -96 dB (indicating no gating) and 0 dB. It is in the same decibel units as the VolumeDecibels component of UserDataSubscription.

  Returns HiFiAudioAPIData