Perguntas frequentes e solução de problemas
Perguntas gerais
O que eu preciso para usar o Mobile MA?
Um servidor Music Assistant auto-hospedado (versão 2.x) que o seu iPhone consiga alcançar. O Mobile MA é um cliente independente — o servidor roda do seu lado, por exemplo, como um add-on do Home Assistant ou um contêiner Docker.
Por que o Mobile MA, se já existe um app oficial?
O app oficial do Music Assistant (Android e iOS) está, segundo o projeto, em fase beta e é distribuído via TestFlight ou Google Play Open Testing. Ele é open source e gratuito – uma boa escolha, especialmente no Android. O Mobile MA é um cliente independente só para aparelhos Apple e está disponível na App Store. A diferença: o Mobile MA inclui Apple Watch, Apple TV e widgets de tela inicial, que atualmente não estão no app oficial, além de CarPlay para cada player da casa e Atalhos da Siri com player de destino – duas áreas que o app oficial não tem como objetivo. Soma-se a isso cenas multiroom e perfis de conexão nomeados com backup no iCloud. As funções básicas são gratuitas, o restante é uma compra única, sem assinatura. Os dois apps usam o mesmo servidor – você pode usá-los em paralelo. (Situação em: 16 de setembro de 2026)
O que é o Mobile MA Unlimited?
Uma compra única (sem assinatura) que libera todos os recursos premium — entre eles, CarPlay, Smart Playlists e transferência de fila. O primeiro toque em um recurso premium inicia um período de teste gratuito de 7 dias, sem nenhum pagamento antecipado.
O Mobile MA funciona com o CarPlay?
Sim — com o Mobile MA Unlimited, a biblioteca completa fica disponível no carro: álbuns, playlists, podcasts, rádio e favoritos, incluindo as capas dos álbuns.
Dados são enviados para o desenvolvedor?
Sua música, seu servidor e suas credenciais: não — o app só fala com o seu próprio servidor. A única exceção são estatísticas de uso anônimas (cinco eventos sobre configuração, período de teste e compra, sem endereço IP ou ID do aparelho), que você pode desativar a qualquer momento em Ajustes, em “Privacidade”. Os detalhes estão na política de privacidade.
Solução de problemas
A música trava ou tem falhas
Aumente o buffer de reprodução em Ajustes — isso compensa áreas sem sinal e Wi-Fi instável. Um buffer maior vale a pena principalmente ao transmitir via dados móveis.
Quero acessar meu servidor quando estiver fora de casa
Configure o acesso remoto por WebRTC em Ajustes — assim você alcança seu Music Assistant também fora da rede local, sem liberação de porta ou VPN. Porém, há uma limitação com dados móveis, veja o próximo item.
O acesso remoto funciona no Wi-Fi, mas não nos dados móveis
Operadoras de celular costumam bloquear conexões WebRTC diretas. Para que a conexão aconteça mesmo assim, o servidor Music Assistant precisa de um relay TURN — e o Music Assistant só disponibiliza isso com uma assinatura do Home Assistant Cloud (Nabu Casa), porque é ali que ficam os custos do tráfego de dados repassado. Sem essa assinatura, o acesso remoto só funciona na sua própria rede, por VPN ou por meio de um servidor acessível de fora. Essa é uma característica do servidor, não do app — veja a resposta da equipe do Music Assistant.
Um player está faltando na lista
Primeiro, verifique se o player está ativo e disponível no próprio servidor Music Assistant. No app, o pull-to-refresh ajuda; depois de trocas de rede, o Mobile MA se reconecta automaticamente.
A reprodução local para ao trocar entre Wi-Fi e dados móveis
Isso foi corrigido desde a versão 2.0 — atualize o app para a versão mais recente.
O widget não atualiza
Verifique se a versão mais recente do app está instalada (muito mais confiável desde a 2.3) e se a atualização em segundo plano está permitida para o Mobile MA nos Ajustes do iOS.