Skip to content
Capítulo 07 • Subsistema de Áudio

Subsistema de Áudio e Streaming

Ponte entre APIs de áudio do Android (OpenSL ES, SoundPool, MediaPlayer) e o hardware do PS Vita usando sceAudioOut, OpenAL-Soft e decodificação OGG Vorbis.

⚡ Nível: Intermediário 🔊 Backends: sceAudioOut, OpenAL-Soft, libvorbisfile 🎮 Verificado: Hero of Sparta, Zenonia 3, Badland 2

Em jogos Android, o áudio geralmente é reproduzido por três vias: 1. OpenSL ES: API nativa em C para áudio de baixa latência. 2. AudioTrack / SoundPool (Java): Classes do Android SDK para efeitos sonoros curtos em memória. 3. MediaPlayer (Java): Classe para streaming de músicas comprimidas (OGG, MP3).

No PlayStation Vita, todo o áudio é direcionado para o kernel através da API sceAudioOut ou via bibliotecas de alto nível como o OpenAL-Soft.


🔊 Arquitetura do Subsistema de Áudio

flowchart TD
    subgraph "Camadas Android no Jogo"
        Music["Música (MediaPlayer / OGG)"]
        SFX["Efeitos (SoundPool / OpenSL ES)"]
    end

    subgraph "Camada de Abstração no Loader"
        Vorbis["Decodificador libvorbisfile"]
        OpenAL["OpenAL-Soft (Contexto & Buffers)"]
        DirectPCM["Buffer Circular PCM"]
    end

    subgraph "Hardware do PS Vita"
        SceAudio["sceAudioOutOutput()"]
        DAC["Alto-falantes / Saída de Fone 3.5mm"]
    end

    Music --> Vorbis --> OpenAL
    SFX --> OpenAL
    OpenAL --> DirectPCM --> SceAudio --> DAC

1. Saída PCM Direta com sceAudioOut

O VitaOS gerencia portas de áudio PCM de 16 bits estéreo:

#include <psp2/audioout.h>

static int audio_port = -1;

void init_audio_hardware(void) {
    audio_port = sceAudioOutOpenPort(
        SCE_AUDIO_OUT_PORT_TYPE_BGM,
        1024,
        44100,
        SCE_AUDIO_OUT_MODE_STEREO
    );

    int vol[2] = { 32768, 32768 }; // 100% de volume
    sceAudioOutSetVolume(audio_port, SCE_AUDIO_VOLUME_FLAG_L_CH | SCE_AUDIO_VOLUME_FLAG_R_CH, vol);
}

void output_pcm_block(const int16_t *samples) {
    sceAudioOutOutput(audio_port, samples);
}

📻 Streaming de Música em OGG Vorbis

Vincule a libvorbisfile para decodificar faixas de áudio comprimidas:

#include <vorbis/vorbisfile.h>

typedef struct {
    OggVorbis_File vf;
    FILE *f;
    int is_playing;
    int loop;
} BGMStream;

BGMStream bgm;

void bgm_play(const char *filepath, int loop) {
    bgm.f = fopen(filepath, "rb");
    if (!bgm.f) return;

    if (ov_open_callbacks(bgm.f, &bgm.vf, NULL, 0, OV_CALLBACKS_DEFAULT) < 0) {
        fclose(bgm.f);
        return;
    }

    bgm.loop = loop;
    bgm.is_playing = 1;
}

int audio_thread(SceSize args, void *argp) {
    int16_t pcm_buffer[2048];
    int bitstream;

    while (1) {
        if (bgm.is_playing) {
            long bytes = ov_read(&bgm.vf, (char *)pcm_buffer, sizeof(pcm_buffer), 0, 2, 1, &bitstream);
            if (bytes > 0) {
                sceAudioOutOutput(audio_port, pcm_buffer);
            } else if (bytes == 0 && bgm.loop) {
                ov_time_seek(&bgm.vf, 0); // Repetir
            }
        } else {
            sceKernelDelayThread(10000);
        }
    }
    return 0;
}

🧩 Emulação de SoundPool no FalsoJNI

Quando o jogo dispara efeitos sonoros via SoundPool.play(...):

jint fake_SoundPool_play(JNIEnv *env, jobject obj, jint soundID, jfloat leftVolume, jfloat rightVolume, jint priority, jint loop, jfloat rate) {
    play_openal_sound_effect(soundID, leftVolume, loop);
    return soundID; // Retorne um stream ID válido (> 0) indicando sucesso
}

[!TIP] Se o método SoundPool.play retornar 0, o jogo pode interpretar como falha de canais do hardware e tentar recarregar o som a cada frame, causando congelamentos severos.