Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.7.0

flutter_displaymode

Um plug-in Flutter para definir o modo de exibição (resolução, taxa de atualização) na plataforma Android. Permite ativar a alta taxa de atualização em dispositivos compatíveis.

Android
Downloads em 30 dias
130 mil
Curtidas
220
Pontos Pub
160

Instalar pacote

flutter pub add flutter_displaymode

Visão geral do pacote

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

flutter_displaymode é um plugin Flutter que permite aos desenvolvedores definir programaticamente modos de exibição — como resolução e taxa de atualização — em dispositivos Android. É especialmente útil para otimizar desempenho e qualidade visual habilitando altas taxas de atualização em hardware compatível. O plugin fornece acesso direto às configurações de tela do Android, permitindo que os aplicativos se adaptem dinamicamente às capacidades do dispositivo. Ele não suporta iOS, pois a funcionalidade é específica da plataforma Android.

Casos de uso

  • Otimizando o desempenho do aplicativo em telas de alta taxa de atualização
  • Habilitar taxas de atualização de 90 Hz ou 120 Hz para aplicativos de jogos
  • Ajustando a resolução de exibição para melhor clareza visual
  • Melhorando a suavidade da interface em aplicações com muitas animações
  • Testando o comportamento de exibição em diferentes configurações de tela

Principais recursos

  • Define a resolução de exibição e taxa de atualização do Android
  • Suporta modos de alta taxa de atualização em dispositivos compatíveis
  • Fornece uma API simples para definir o modo de exibição
  • Específico para Android
  • Não requer acesso root

Indicado para

  • desenvolvedores de jogos Android
  • Aplicativos que exigem renderização de UI de alto desempenho
  • Desenvolvedores direcionados a dispositivos Android premium
  • Aplicações focadas na fidelidade visual
  • Ferramentas de teste de capacidades de exibição

Considerações

  • Funciona apenas em dispositivos Android
  • Requer suporte do dispositivo para alterações dinâmicas no modo de exibição
  • Pode não funcionar em todas as versões do Android
  • Alterações podem ser revertidas pelo sistema ou usuário
  • Limitado às capacidades específicas do hardware

README original

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

Flutter Display Mode

pub package

A Flutter plugin to set display mode in Android. This is useful to enable high refresh rate in devices with discrete framerates like 60Hz, 90Hz etc. This library is ineffective on devices with LTPO panels and iOS devices with ProMotion.

This library should be used as a temporary fix to #35162 until this API gets added to Flutter engine itself.

Getting Started

Add library to pubspec then and rebuild your app:

flutter pub add flutter_displaymode
Set to highest/lowest framerate

Use helper functions FlutterDisplayMode.setHighRefreshRate or FlutterDisplayMode.setLowRefreshRate to switch to highest or lowest refresh rate maintaining current resolution.

// current: #1 1440x3120 @ 60Hz
// new: #2 1440x3120 @ 90Hz
await FlutterDisplayMode.setHighRefreshRate();

// current: #2 1440x3120 @ 90Hz
// new: #1 1440x3120 @ 60Hz
await FlutterDisplayMode.setLowRefreshRate();
Get supported modes

FlutterDisplayMode.supported returns all the modes that can be set as the preferred mode. This always returns DisplayMode.auto as one of the modes.

import 'package:flutter_displaymode/flutter_displaymode.dart';

try {
  modes = await FlutterDisplayMode.supported;
  modes.forEach(print);

  /// On OnePlus 7 Pro:
  /// #0 0x0 @0Hz // Automatic
  /// #1 1080x2340 @ 60Hz
  /// #2 1080x2340 @ 90Hz
  /// #3 1440x3120 @ 90Hz
  /// #4 1440x3120 @ 60Hz

  /// On OnePlus 8 Pro:
  /// #0 0x0 @0Hz // Automatic
  /// #1 1080x2376 @ 60Hz
  /// #2 1440x3168 @ 120Hz
  /// #3 1440x3168 @ 60Hz
  /// #4 1080x2376 @ 120Hz
} on PlatformException catch (e) {
  /// e.code =>
  /// noAPI - No API support. Only Marshmallow and above.
  /// noActivity - Activity is not available. Probably app is in background
}
Get active mode

FlutterDisplayMode.active fetches the currently active mode. This is not always the preferred mode set by FlutterDisplayMode.setPreferredMode. It can be altered by the system based on the display settings.

final DisplayMode m = await FlutterDisplayMode.active;
Set preferred mode

FlutterDisplayMode.setPreferredMode changes the preferred mode. It is upto the system to use this mode. Sometimes system can choose not switch to this based on internal heuristics. Check FlutterDisplayMode.active to see if it actually switches.

/// This setting is per session. 
/// Please ensure this was placed with `initState` of your root widget.
await FlutterDisplayMode.setPreferredMode(modes[1]);
Get preferred mode

FlutterDisplayMode.preferred returns the currently preferred mode. If not manually set with FlutterDisplayMode.setPreferredMode then it will be DisplayMode.auto.

final DisplayMode m = await FlutterDisplayMode.preferred;

You can check out a complete example here.

Categorias

Repositório-fonte

Projetos que usam este pacote