Sobre o projeto
react-native-track-player é uma biblioteca de reprodução de áudio para aplicativos React Native. De acordo com seu README, ela é construída na Nova Arquitetura usando JSI e TurboModules, visando evitar sobrecarga e instabilidade da ponte.
Principais capacidades descritas no README:
- API TypeScript simples com tipagem completa para desenvolvedores React Native
- Implementação nativa da Nova Arquitetura via JSI com suporte a TurboModule
- Reprodução em segundo plano, para que o áudio continue quando o aplicativo estiver em segundo plano ou a tela estiver desligada
- Suporte a Android Auto para integração nativa com painéis de carro
- Pré-carregamento, descrito como buffer em segundo plano das próximas faixas para reprodução semelhante a sem emendas
- Cache de áudio integrado para reduzir uso de banda e permitir reprodução offline
- Controles remotos, incluindo tela de bloqueio, controles de notificação e suporte a fones de ouvido
- Hooks React como usePlaybackState, useIsPlaying, useProgress e useActiveMediaItem
Requisitos: React Native 0.74 ou posterior, com a Nova Arquitetura habilitada (Fabric + TurboModules). A instalação é feita via npm install @rntp/player, seguida de pod install para iOS; Android vincula automaticamente.
O README mostra um fluxo de início rápido: chame TrackPlayer.setupPlayer uma vez na inicialização do aplicativo (em primeiro plano no Android) com opções como contentType, handleAudioBecomingNoisy e android.wakeMode; adicione itens de mídia com url, title, artist e artwork; chame TrackPlayer.play(); e consuma hooks na interface.
A V5 é descrita como uma reescrita completa que não é compatível com versões anteriores da V4. As melhorias declaradas da V5 incluem retornos síncronos de getProgress(), getQueue() e isPlaying(), suporte completo a TurboModule e Fabric, e camadas nativas reescritas para Android e iOS.
O licenciamento é uma consideração importante: a partir da V5, o projeto tem licença comercial. O uso pessoal e educacional permanece gratuito, enquanto o uso comercial requer uma licença paga. A V4 e versões anteriores permanecem disponíveis sob Apache-2.0 no branch v4. Documentação completa e referência de API estão hospedadas em rntp.dev.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.