Playing sound is supported in Hology Engine using ThreeJS. See their documentation for more detail on how to use Audio and Positional Audio.

Playing sound

In the code below we can see how we can utilize Audio instances, load audio files and play sound.

The following numbered points refer to different parts of the code below.

  1. Each sound that needs to be played needs its own instance of Audio. You can reuse audio instances but to play multiple sounds at the same time, you will need separate instances.

  2. Load an audio file directly from the public directory. These don't have to be imported in the editor before.

  3. To use the loaded audio, use the setBuffer function. You can also adjust the volume and other settings which you can read more about in the ThreeJS docs.

  4. Play the sound. If the sound is already playing however, you need to stop it first.

import { inject, Service, World, GameInstance, ViewController, AssetLoader } from '@hology/core/gameplay';
import * as THREE from 'three';

class Game extends GameInstance {
  private world = inject(World)
  private view = inject(ViewController)
  private assetLoader = inject(AssetLoader)

  // 1
  private sound = new THREE.Audio(this.view.audioListener);

  async onStart() {    
    // 2
    const buffer = await this.assetLoader.getAudioAtPath('data/asset-resources/impactWood_heavy_001.ogg')
    // 3

  playSound() {
    if (this.sound.isPlaying) {
    // 4;

export default Game

You can see a complete example for playing sound and run it locally to it out yourself here.

Last updated