# Efeitos sonoros e música locais (Stable Audio 3)

> Runtime para efeitos sonoros e música locais no AI Game Dev com sa3.cpp, o port C++/ggml do Stable Audio 3, em CUDA, Vulkan, Metal ou na CPU, sem Python. Executa os modelos Stable Audio 3 Small SFX, Small Music e Medium, que são pacotes separados.

- Id: `aigd.sa3cpp`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: Áudio
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.0.2 (publicado em 2026-11-22)
- Licença: MIT
- Requer o app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.sa3cpp

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.sa3cpp
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.sa3cpp` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | mais recente |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descrição

````markdown
# Efeitos sonoros e música locais (`aigd.sa3cpp`)

Efeitos sonoros e música locais é o runtime que permite ao app AI Game Dev criar efeitos sonoros e música instrumental no seu próprio computador com os modelos Stable Audio 3. Ele usa [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp), um port C++/ggml do Stable Audio 3 da Stability AI que dispensa Python. Tudo é criado no seu computador, e criar não custa nada. É indicado para desenvolvedores de jogos que querem SFX, foley, sons de UI e música de fundo sem um serviço de nuvem.

## O que ele faz

- Baixa a release do sa3.cpp adequada ao seu computador (Windows, Macs com Apple silicon, ou Intel Macs e Linux como preview; CUDA, Vulkan, Metal ou CPU), verifica por sha256 e a executa.
- Adiciona a chave **SFX & Music** à barra Tools da sessão. A chave fica desligada até você ativá-la em uma sessão.
- Executa `sa3-generate` uma vez por som e não mantém nenhum servidor em execução.

Este pacote é apenas dados (`aigd-package.json`, sem código). Ele informa ao AI Game Dev qual release do sa3.cpp baixar para o seu computador. O app baixa, verifica e executa o programa por conta própria.

## Os modelos são pacotes separados

Este pacote não contém nenhum modelo. Instale um pacote de modelo pelo navegador de Pacotes e depois baixe os arquivos dele no painel Modelos:

| Pacote | O que ele cria |
|---|---|
| [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx) (`aigd.audio-stable-audio-3-small-sfx`) | efeitos sonoros e foley, até 60 s |
| [Stable Audio 3 Small Music](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-music) (`aigd.audio-stable-audio-3-small-music`) | música instrumental, até 2 minutos |
| [Stable Audio 3 Medium](https://ai-game.dev/packages/aigd.audio-stable-audio-3-medium) (`aigd.audio-stable-audio-3-medium`) | música instrumental, até 6 min 20 s |

Nada é baixado sem a sua confirmação. Você vê primeiro o tamanho e a licença do modelo. Os modelos Stable Audio 3 têm licença própria, com limite de receita, dever de registro e um aviso "Powered by Stability AI". O README de cada pacote de modelo apresenta esses termos.

Outros modelos locais de música, efeitos sonoros e fala são executados em [Geração de áudio local](https://ai-game.dev/packages/aigd.audiocpp) (`aigd.audiocpp`).

## Exemplos de pedidos

Com o **SFX & Music** ativado e um modelo instalado, você pede ao agente em palavras simples:

- "Crie um som curto de disparo de laser para a arma do jogador."
- "Gere passos na neve, 4 segundos."
- "Crie um instrumental lo-fi relaxante de 90 segundos para o menu principal."

## O que é baixado

O app baixa uma release upstream, fixada por tag e verificada por sha256: `betweentwomidnights/sa3.cpp` [`v0.2.4`](https://github.com/betweentwomidnights/sa3.cpp/releases/tag/v0.2.4) (commit `3152253`). O upstream a marca como pré-release. O app escolhe uma variante para o seu computador.

| Variante | Computador | Download |
|---|---|---|
| `win-x64-cuda12` | Windows, GPU NVIDIA (driver 572.61 ou mais recente, compute capability 6.1 ou mais recente) | 752 MB (programa + runtime NVIDIA CUDA 12.8) |
| `win-x64-vulkan` | Windows, GPUs AMD / Intel / outras | 19 MB (núcleo + backend Vulkan) |
| `win-x64-cpu` | Windows, sem GPU utilizável (lento; o Medium precisa de GPU) | 7 MB |
| `darwin-arm64-metal` | Mac com Apple silicon, macOS 13.3 ou mais recente | 11 MB (assinado e notarizado pelo upstream) |
| `darwin-x64-cpu` | Intel Mac, macOS 13.3 ou mais recente (somente CPU) | 11 MB |
| `linux-x64-vulkan` | Linux x64 com GPU Vulkan, **glibc 2.38 ou mais recente** (Ubuntu 24.04+, Debian 13+). Requer `libgomp.so.1` e `libvulkan.so.1` | 22 MB |
| `linux-x64-cpu` | Linux x64 sem GPU utilizável, glibc 2.38 ou mais recente. Requer `libgomp.so.1` | 12 MB |

A variante CUDA para Windows usa o archive autônomo do upstream. É o único archive que carrega o runtime CUDA (`cudart64_12`, `cublas64_12`, `cublasLt64_12`). O archive dividido `cuda` contém apenas `ggml-cuda.dll` e espera um runtime CUDA 12.8 instalado em todo o sistema.

**Previews.** As variantes de Linux e Intel Mac ainda não foram testadas em hardware real, e o upstream não valida a geração por CPU. Elas são selecionáveis e marcadas como "preview".

O app nunca instala drivers nem bibliotecas de sistema. Se faltar algo, ele informa o que instalar.

## Licença

- sa3.cpp — MIT, © 2026 betweentwomidnights ([licença](https://github.com/betweentwomidnights/sa3.cpp/blob/3152253622d8b54deec14bfb0938371a5bd20439/LICENSE)).
- ggml — MIT, © The ggml authors ([ggml-org/ggml](https://github.com/ggml-org/ggml)).
- cpp-httplib (MIT, © yhirose), yyjson (MIT, © YaoYuan), Signalsmith Stretch e Signalsmith Linear (MIT, © Signalsmith Audio). Os arquivos de licença deles vêm dentro dos archives.
- Motor de prompts RoyalCities RC-stable-audio-tools (MIT, © 2023 Stability AI), adaptado nas ferramentas `sat-*` ([código-fonte](https://github.com/RoyalCities/RC-stable-audio-tools)). O AI Game Dev não executa essas ferramentas; a licença está no `THIRD_PARTY_NOTICES.md` dos archives.
- Runtime do Microsoft Visual C++ (`msvcp140`, `vcruntime140`, `vcruntime140_1`, `vcomp140`), apenas nas variantes para Windows. O upstream o redistribui sob os termos do Visual Studio 2022 para código redistribuível.
- Runtime NVIDIA CUDA (cudart, cuBLAS), apenas na variante CUDA para Windows. O upstream o redistribui sob a [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/), e `NVIDIA-CUDA-EULA.txt` vem no archive.
- Este pacote — MIT. O runtime não contém pesos de modelo. Cada pacote de modelo declara sua própria licença.

Todos os arquivos são baixados da release do GitHub do upstream. O AI Game Dev não os hospeda.
````
