Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Detalhes do pacotev3.7.1

volume_controller

Um plugin de volume do Flutter para múltiplas plataformas para controlar o volume do sistema.

AndroidiOSmacOSWindowsLinux
pub.dev Documentação da API Código-fonte
Downloads em 30 dias
187 mil
Curtidas
132
Pontos Pub
160

Instalar pacote

flutter pub add volume_controller

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote volume_controller é um plugin cross-platform do Flutter que permite aos desenvolvedores controlar o volume do sistema em Android, iOS, macOS, Windows e Linux. Ele fornece uma API simples para ajustar, silenciar e consultar níveis de volume, sendo ideal para aplicativos de mídia, ferramentas de áudio ou qualquer aplicativo que exija controle de áudio de nível de sistema. O plugin abstrai as implementações específicas de plataforma, garantindo comportamento consistente entre dispositivos. Suporta monitoramento de volume baseado em stream e manipulação direta do volume. Desenvolvido com foco na facilidade de integração, funciona perfeitamente em projetos existentes do Flutter.

Casos de uso

  • Controle de volume do player de mídia
  • Integração do sistema de aplicativo de áudio
  • Ferramentas de acessibilidade
  • Testes automatizados de recursos de áudio
  • Ajustes de volume globais

Principais recursos

  • Suporte multiplataforma (Android, iOS, macOS, Windows, Linux)
  • Ajuste de nível de volume e muting
  • Monitoramento em tempo real do volume por meio de streams
  • API simples e consistente
  • Abstração de plataforma para controles nativos de volume

Indicado para

  • Desenvolvedores de aplicativos centrados em áudio
  • Aplicativos que precisam de acesso ao volume do sistema
  • Utilitários de áudio multiplataforma
  • Testando comportamentos de áudio entre sistemas operacionais

Considerações

  • Requer permissões apropriadas da plataforma
  • O comportamento pode variar levemente entre os sistemas operacionais
  • Limitado ao volume do sistema (não específico do aplicativo)
  • Não adequado para processamento de áudio de baixo nível
  • Pode exigir permissão do usuário em algumas plataformas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Volume Controller

pub package license

Control and observe the system volume on Android, iOS, macOS, Windows, and Linux.

Requirements

  • Flutter >=3.44.0
  • Dart ^3.12.0

The iOS plugin uses the scene lifecycle APIs introduced for Flutter plugins in Flutter 3.38.

Supported Platforms

Platform Supported
Android ✅
iOS ✅
macOS ✅
Windows ✅
Linux ✅

Notes

  • iOS volume control must be tested on a real device. The simulator does not support system volume control.
  • showSystemUI is supported on Android and iOS only.
  • Mute is not volume 0 on every platform:
    • Windows, macOS, Linux: system mute. Volume can stay non-zero while muted.
    • Android API 23+: STREAM_MUSIC mute (isStreamMute / ADJUST_MUTE).
    • Android API 21–22: mute sets volume to 0 and unmute restores the previous volume saved by the plugin.
    • iOS: there is no public system media mute API. isMuted() is volume == 0. setMute(true) sets volume to 0; setMute(false) restores the previous volume saved by the plugin. iOS 26 AVAudioSession.setOutputMuted is not used, because it mutes this app's audio session rather than the system volume.

Variables

ShowSystemUI

Show or hide the volume system UI. The default value is true. Supported on iOS and Android only.

VolumeController.instance.showSystemUI = true;

Functions

GetVolume

Get the current system volume.

double volume = await VolumeController.instance.getVolume();
SetVolume

Set the system volume. The input should be in the range 0.0 to 1.0.

await VolumeController.instance.setVolume(double volume);
AddListener

Add a listener to monitor system volume changes.

  • fetchInitialVolume: Send the current volume immediately. Defaults to true.
VolumeController.instance.addListener((volume) {
  // Do something with the volume
}, fetchInitialVolume: true);
RemoveListener

Remove the volume listener.

await VolumeController.instance.removeListener();
IsMuted

Check whether the system is muted.

bool isMuted = await VolumeController.instance.isMuted();
SetMute

Mute or unmute the system volume.

await VolumeController.instance.setMute(bool mute);

Categorias

Software e hardware de dispositivos Android/iOS

Repositório-fonte

Projetos que usam este pacote