Spatial audio connection function "3D Transceiver"

Sample directory

/cri/pc/samples/criatomex/control_3d_pos_transceiver

Data used in the sample

/cri/common/smpdata/criatomex/

• SampleProject.acf
• AtomCueSheet.acb
• AtomCueSheet.awb
  

Sample description

The spatial audio connection function "3D Transceiver" is a function that expands the conventional 3D positioning.
For a detailed explanation of the function, please refer to Spatial audio connection function "3D Transceiver" .
For details on 3D positioning, please refer to the sample: 3D positioning .

To achieve spatial audio expression using a transceiver, the following elements are required.

• 3D transceiver handle: CriAtomEx3dTransceiverHn
• 3D region handle: CriAtomEx3dRegionHn

To set the parameters of the 3D transceiver handle, use the following functions, just like the listener and sound source.

• Input position: criAtomEx3dTransceiver_SetInputPosition function
• Output position: criAtomEx3dTransceiver_SetOutputPosition function
• Output cone: criAtomEx3dTransceiver_SetOutputConeParameter function

After setting the parameters, use the following function to actually reflect the parameters.

• criAtomEx3dTransceiver_Update

3D regions represent areas in the 3D space of the game. Use the following functions to set listeners, sound sources, and transceivers.

• criAtomEx3dListener_Set3dRegionHn
• criAtomEx3dSource_Set3dRegionHn
• criAtomEx3dTransceiver_Set3dRegionHn

The code for 3D positioning using a 3D transceiver is shown below.

/* Variable declaration */
CriAtomEx3dListenerHn listener;
CriAtomEx3dSourceHn source;
CriAtomEx3dTransceiverHn transceiver;
CriAtomEx3dRegionHn region_a, region_b;
CriAtomExVector pos;
 
/* Create each object */
listener = criAtomEx3dListener_Create(NULL, NULL, 0);
source = criAtomEx3dSource_Create(NULL, NULL, 0);
transceiver = criAtomEx3dTransceiver_Create(NULL, NULL, 0);
region_a = criAtomEx3dRegion_Create(NULL, NULL, 0);
region_b = criAtomEx3dRegion_Create(NULL, NULL, 0);
 
/* Set the sound source and listener to the EX player */
player = criAtomExPlayer_Create(NULL, NULL, 0);
criAtomExPlayer_Set3dListenerHn(player, listener);
criAtomExPlayer_Set3dSourceHn(player, source);
 
/* Setting the Region */
criAtomEx3dListener_Set3dRegionHn(source, region_a);
criAtomEx3dSource_Set3dRegionHn(source, region_b);
criAtomEx3dTransceiver_Set3dRegionHn(transceiver, region_b);
 
/* Setting parameters */
pos.x = 0.0f;
pos.y = 0.0f;
pos.z = 0.0f;
criAtomEx3dSource_SetPosition(source, &pos);
criAtomEx3dSource_Update(source);
            :
criAtomEx3dListener_Update(listener);
            :
criAtomEx3dTransceiver_Update(transceiver);
 
/* Start playback */
id = criAtomExPlayer_Start(player);
            :
pos.x += 10.0f;
criAtomEx3dSource_SetPosition(source, &pos);
criAtomEx3dSource_Update(source);
            :
/* Change listener region */
criAtomEx3dListener_Set3dRegionHn(listener, region_b);
criAtomEx3dListener_Update(listener)

Sample program: Scene 1

Sample program: Scene 1 is designed to let sounds from another space, such as a room, leak out from an opening.
Two transceivers are set in the location shown as 3D transceiver in the diagram, with the input and output positions set to the same coordinates, and output the sound sources belonging to the outdoor and indoor regions together.
This is due to the specification that one 3D transceiver is required for each 3D region. As a result, two 3D transceivers are required at the connection between the two spaces.

This sample monitors the listener coordinates, determines whether the 3D listener is outdoors or indoors, and sets the appropriate region to the 3D listener.
The operation of the 3D transceiver is based on the 3D region, so please set the 3D region appropriately in your game program.

/* Listener region switching */
/* Switch region of listener */
if (0.0f < listener->transform.pos.z) {
        listener->region_index = 0;
} else {
        listener->region_index = 1;
}
criAtomEx3dListener_Set3dRegionHn(listener->hn, s_app_obj->regions[listener->region_index]);

In this sample, crossfading is performed around the 3D transceiver. For information on crossfading, please refer to the Spatial audio connection function "3D Transceiver" page.

Related API

• criAtomEx3dTransceiver_SetInputCrossFadeField

Sample Program: Scene 2

Sample Program: Scene 2 is designed to output a sound from another space to another space by a transceiver.
There is one 3D transceiver, and the 3D transceiver transmits outdoor sounds to an indoor listener.

3D positioning calculations are also performed between the 3D sound source and the 3D transceiver, so you can see that the sound coming from the transceiver output gets quieter as the helicopter sound source moves away.