How to Use Criware’s Api for Custom Audio Controls in C++ Projects

Integrating custom audio controls into your C++ projects can significantly enhance user experience. Criware offers a comprehensive API that allows developers to manage audio playback, volume, and other features seamlessly. This guide provides a step-by-step overview of how to utilize Criware’s API effectively.

Getting Started with Criware API

Before diving into coding, ensure you have the Criware SDK installed and properly configured in your development environment. You will need to include the relevant headers and link against the Criware libraries.

Initializing the Audio System

Initialize the Criware audio system at the start of your application. This typically involves calling the initialization functions provided by the API.

#include <cri/include/cri_le.h>

void InitializeCriware() {
    CriLeInitialize();
    // Additional setup code as needed
}

Setting Up Audio Playback

Create and configure audio objects to play sounds. Use the CriAtomExPlayer class for this purpose.

#include <cri/include/cri_atom_ex.h>

CriAtomExPlayer *player;

void SetupAudio() {
    player = CriAtomExPlayer_Create(NULL, NULL, 0);
}

Playing Audio Files

Load your audio data and start playback using the CriAtomExPlayer functions.

void PlaySound(const char* filename) {
    CriAtomExPlayer_SetFileName(player, filename);
    CriAtomExPlayer_Start(player);
}

Controlling Audio Playback

You can control volume, pitch, and playback state with the API functions.

void SetVolume(float volume) {
    CriAtomExPlayer_SetVolume(player, volume);
}

void PauseAudio() {
    CriAtomExPlayer_Pause(player, TRUE);
}

void ResumeAudio() {
    CriAtomExPlayer_Pause(player, FALSE);
}

void StopAudio() {
    CriAtomExPlayer_Stop(player);
}

Cleaning Up Resources

When your application closes or no longer needs the audio system, release resources properly to prevent memory leaks.

void Cleanup() {
    CriAtomExPlayer_Free(player);
    CriLeFinalize();
}

Additional Tips

Always check the return values of API functions for errors.
Use separate players for different sounds to manage multiple audio streams.
Refer to the Criware documentation for advanced features like 3D audio and effects.

With these steps, you can integrate Criware’s API into your C++ projects and create rich, interactive audio experiences for your users.

Table of Contents