hardware_buttons

Visão geral do pacote

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

O pacote hardware_buttons é um plugin do Flutter que permite detectar botões de hardware físicos em dispositivos iOS e Android, incluindo os botões de volume para cima/baixo e o botão de home. Ele fornece uma API simples para escutar eventos de pressionamento de botões, permitindo que desenvolvedores respondam às interações com hardware dentro de seus aplicativos. Isso é particularmente útil para controles de mídia, atalhos de navegação ou comportamentos específicos do dispositivo. O plugin é compatível com ambas as plataformas e se integra perfeitamente ao sistema de eventos do Flutter. É ideal para aplicações que exigem manipulação de entrada de hardware de baixo nível.

Casos de uso

Controle de reprodução de mídia
Gestos de navegação personalizados
Comportamento do aplicativo específico do dispositivo
Melhorias de acessibilidade
Integração de controle de jogo

Principais recursos

Detecção em tempo real de eventos de botão
Suporte multiplataforma (iOS e Android)
API de ouvinte de evento simples
Leve e fácil de integrar
Suporta botões de volume e home

Indicado para

Aplicativos móveis que precisam de interação com hardware
Aplicativos de player de mídia
Aplicativos focados em acessibilidade
Jogos que usam controles físicos
Aplicativos que exigem lógica específica do dispositivo

Considerações

Limitado a botões de hardware específicos
Sem suporte a hardware de terceiros
Requer permissões específicas da plataforma
Pode não funcionar em todos os modelos de dispositivo
O tratamento de eventos depende da disponibilidade no nível do sistema operacional

README original

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

DEPRECATED

This plugin is deprecated :( We're no longer able to maintain it.

A Flutter plugin for iOS and Android for detecting various hardware buttons.

Note: This plugin is still under development, and some APIs might not be available yet. Feedback and Pull Requests are most welcome!

Screenshots

Features

Detect volume buttons
Detect home button
Detect lock(power) button
To be added...

Android specification

If you subscribe to volume button events, this plugin will inevitably request for ACTION_MANAGER_OVERLAY_PERMISSION, since we found out this was the only way to do it well in Flutter Plugin environment. We do show permission request window for you, so there's nothing you should do other than subscribing to the event channel. However, since users may be surprised why your app needs this permission, we suggest notifying users beforehand why this permission will be requested.
Migrated to AndroidX as of version 1.0.0. To use with original support libraries, use version 0.2.4. Note, however, pre-AndroidX will no longer be supported.

iOS specification

No VOLUME_DOWN events are emitted when the volume is already at its minimum. VOLUME_UP events vice versa. On the other hand, events always occur whenever user presses the button on Android.

Usage

Import the package

To use this plugin, follow the plugin installation instructions.

To use with AndroidX, install the latest version as above instructions. To use with original support libraries, install version 0.2.4 instead.

Use the plugin

Add the following import to your Dart code:

import 'package:hardware_buttons/hardware_buttons.dart';

In order to listen to volume button events, use volumeButtonEvents.listen as below:

StreamSubscription _volumeButtonSubscription;

@override
void initState() {
  super.initState();
  _volumeButtonSubscription = volumeButtonEvents.listen((VolumeButtonEvent event) {
    // do something
    // event is either VolumeButtonEvent.VOLUME_UP or VolumeButtonEvent.VOLUME_DOWN
  });
}

@override
void dispose() {
  super.dispose();
  // be sure to cancel on dispose
  _volumeButtonSubscription?.cancel();
}

Besides volume button events, there are also:

Home button events, via homeButtonEvents.listen.
Lock button events, via lockButtonEvents.listen.

Example

Find the example wiring in the example app.

API details

See the hardware_buttons.dart for more API details.

Issues and feedback

Please file issues to send feedback or report a bug. Thank you!

Buscar pacotes, repositórios e categorias de apps