Visão geral
Integra ao Control4 os streamers baseados na plataforma LinkPlay: streaming, Bluetooth e USB do aparelho aparecem como fontes nos ambientes, com informações da mídia e capa do álbum.
Aparelhos compatíveis
- SoundSmart, Arylic, AAT Audio Cast, AAT PMR 9/12 e demais com streaming
- Savage Stream Pro, Loud Streaming Media Player, iEast
- Wave integrado às matrizes
- WiiM (use https na propriedade http-https)
Recursos
- Nome da música, artista, álbum, capa e barra de progresso no Control4.
- Liga o ambiente automaticamente quando alguém começa a tocar pelo aplicativo, AirPlay, Bluetooth ou USB.
- Navegação pelo próprio Control4: Presets do aparelho, rádios do TuneIn (com Favoritos) e Tidal (busca, Coleção da conta, página do artista e salvar a fila como playlist).
- Escolha de quais abas aparecem no Navigator.
- Multiroom entre aparelhos LinkPlay pela rede.
Requisitos
- Aparelho LinkPlay na mesma rede do controlador, com IP fixo ou reservado.
- Aplicativo do fabricante (4Stream, WiiM Home, Arylic ou similar) para configurar o aparelho na rede e entrar nas contas dos serviços de streaming.
- Para tocar o Tidal pelo Control4, a conta Tidal precisa estar conectada no aplicativo do aparelho. A conta conectada no driver (veja a seção Tidal) serve para navegar na Coleção e salvar playlists.
Instalação
- Adicione o driver ao projeto e preencha o IP do aparelho em Device IP, ou use Devices on Network > Scan Devices e escolha o aparelho na lista.
- Para WiiM, ajuste http-https para https.
- Aguarde Connection Status indicar conectado.
- Faça as conexões de áudio do driver aos ambientes e oculte os players não usados nas propriedades de cada ambiente.
Cada driver gera 3 players (Streaming, Bluetooth e USB) além do próprio. Oculte os não usados nas propriedades do ambiente.
Ambiente exibindo todas as opções
Ambiente apenas com streaming
Nunca deixe apenas uma opção no Ouvir do ambiente: mantenha outra fonte ou o driver de mídia como opção.
Propriedades
Geral
| Propriedade | Descrição |
|---|---|
| Debug Mode | Ligue em Print para gerar log para o suporte. |
| Chave / Validacao / Cloud Status / Automatic Updates / Developer Access | Licenciamento e uso interno da 4Drivers. |
| Command Delay-Milliseconds | Tempo entre comandos enviados ao aparelho. |
| Protocol | Forma de controle do aparelho: HTTP (padrão, maioria dos aparelhos) ou TCP (aparelhos com controle por TCP). |
| Volume Ramp Delay-Milliseconds | Tempo entre comandos de volume ao segurar o botão. |
Auto Room Select
| Propriedade | Descrição |
|---|---|
| Auto Select Room | Quais fontes ligam o ambiente automaticamente quando o aparelho começa a tocar: Streaming, Bluetooth, USB, All (todas) ou No (desligado). |
| Room to be Selected | Ambiente que será ligado com o player quando a reprodução começar. |
Turn OFF Settings
| Propriedade | Descrição |
|---|---|
| Auto Select Requires Play | Com Yes (padrão), o ambiente só liga automaticamente quando o aparelho começa de fato a tocar, por exemplo quando alguém dá play pelo aplicativo do celular ou via AirPlay. Evita que o ambiente ligue sozinho quando um aplicativo apenas se reconecta ao aparelho ou quando a rádio recarrega. Com No, volta ao comportamento anterior: liga assim que o aparelho muda de fonte, mesmo sem tocar. |
| Auto Select Quiet After OFF (seconds) | Depois que o ambiente é desligado pelo Control4, o driver não religa o ambiente automaticamente durante esse tempo (padrão 30 segundos). Se nesse período alguém der play de verdade e a música continuar tocando, o ambiente liga assim que o tempo termina. Zero desativa. |
| Auto Room Off (minutes) | Desliga o ambiente depois desse tempo com a música pausada ou parada (pelo aplicativo ou pelo Control4). Zero desativa. |
| Switch INPUT on turn OFF | Entrada nula usada ao desligar. Veja a seção Desligar o ambiente: entrada nula. |
| Set Prompt Voice OFF | Desliga os avisos de voz do aparelho ao desligar o ambiente. |
Volume Settings
| Propriedade | Descrição |
|---|---|
| Current Volume | Volume atual do aparelho (somente leitura). |
| Volume when Turns OFF | Ajusta o volume ao desligar. Útil para o aparelho continuar servindo som aos demais pela rede sem tocar no ambiente. Com -1 o volume não é alterado. Para players embutidos no multiroom ou ligados em entradas deles, sugerimos 99%; nunca faça isso em players amplificados. |
| Max Volume Limiter | Limita o volume máximo quando aumentado pelo Control4. |
Driver Update Info
| Propriedade | Descrição |
|---|---|
| Last Server Version | Última versão do driver disponível em 4drivers.com.br. |
| Server Version Notes | Comentários sobre a última versão disponível. |
Network
| Propriedade | Descrição |
|---|---|
| http-https | Para WiiM use https; para os demais, http (padrão). |
| Devices on Network | Procura aparelhos LinkPlay na rede: escolha Scan Devices, aguarde a propriedade piscar e selecione o aparelho. O IP é preenchido em Device IP. |
| Device IP | IP do aparelho, se preferir preencher manualmente. Deve estar fixo ou reservado. |
| Polling Interval | Tempo entre consultas ao aparelho. Tempos longos deixam as informações da mídia mais lentas. |
Info
| Propriedade | Descrição |
|---|---|
| Driver Version | Versão do driver. |
| Device Name | Nome do aparelho. |
| Connection Status | Estado da conexão. Após um minuto sem resposta, o aparelho é considerado desconectado. |
Navigator Tabs
| Propriedade | Descrição |
|---|---|
| Show Presets Tab / Show TuneIn Tab / Show Tidal Tab | Mostra ou esconde cada aba no Navigator. Ex.: esconda a aba Tidal se o cliente não assina Tidal. A mudança vale na próxima vez que o usuário entrar no driver pelo Navigator. Se todas estiverem em No, a aba Presets continua aparecendo. |
| TuneIn Favorites | Shared with other LinkPlay drivers (padrão): a lista de rádios favoritas é a mesma em todos os aparelhos LinkPlay do projeto com esta opção. This device only: lista própria deste aparelho. |
Tidal
| Propriedade | Descrição |
|---|---|
| Tidal Country Code | País da conta Tidal (padrão BR). |
| Tidal Shortcuts | Atalhos de busca exibidos na aba Tidal, separados por vírgula. |
| Tidal Account | Mostra se uma conta Tidal está conectada ao driver (somente leitura). |
Desligar o ambiente: entrada nula
Ao desligar o ambiente, o driver para a música e muda o aparelho para a entrada escolhida em Switch INPUT on turn OFF. Como não há nada ligado nessa entrada, o aparelho fica em silêncio e nenhum streaming continua tocando escondido.
- Escolha uma entrada que exista de verdade no aparelho e que não esteja em uso. Na maioria dos aparelhos a melhor opção é Line In.
- Use Optical, HDMI ou USB somente se o aparelho tiver essa entrada: se a entrada escolhida não existir, o aparelho simplesmente ignora a troca.
Em alguns aparelhos, a música do Tidal iniciada pelo Control4 continua avançando depois do comando de parar (com o som mudo) e pode voltar a tocar sozinha, às vezes religando o ambiente. Com a entrada nula correta isso não acontece. Como reforço, depois de desligar o driver confere se a música realmente parou e, se não parou, insiste até parar.
Como conferir na instalação
- Toque uma playlist do Tidal pelo Control4.
- Desligue o ambiente e aguarde cerca de 1 minuto.
- A barra de progresso não deve continuar andando e a música não deve voltar. Se voltar, troque a entrada (por exemplo, de Optical para Line In) e repita o teste.
Não utilize a entrada nula se o aparelho serve áudio a outros ambientes (por exemplo, ligado numa controladora distribuindo áudio): deixe em No, ou em Line In.
Navegação no Navigator
Presets
Toca os presets salvos no aparelho. Por padrão eles aparecem numerados; para renomear, abra as opções do preset e escolha Rename Preset, ou Rename with Current para usar o nome do que está tocando. Os presets são salvos pelo aplicativo do aparelho.
TuneIn
- Navegue por categorias, locais e idiomas, ou use a busca do Navigator.
- Favoritos: pasta no topo da aba TuneIn. Para adicionar, abra as opções de uma rádio em qualquer lista e escolha Adicionar aos favoritos. Com uma rádio do TuneIn tocando, a opção também aparece no topo da fila da tela Tocando agora (ícone de fila). Para tirar, use Remover dos favoritos.
- Até 60 rádios. Com TuneIn Favorites em Shared, a lista é a mesma em todos os aparelhos LinkPlay do projeto.
Lista de rádios do TuneIn
Pasta Favoritos
Tidal
- Busca de álbuns, artistas, músicas e playlists, atalhos configuráveis e tocados recentemente.
- Página do artista: mais tocadas, álbuns, EPs e singles (mais recentes primeiro), rádio do artista, playlists com o artista e artistas semelhantes.
- Coleção: playlists, álbuns, músicas e artistas favoritos da conta Tidal do cliente.
- Salvar fila como playlist: com o Tidal tocando, abra a fila da tela Tocando agora (ícone de fila) e toque no item do topo. A playlist é criada na conta Tidal do cliente com as faixas da fila.
Pausa no Tidal
Alguns aparelhos LinkPlay não obedecem ao comando de pausa enquanto tocam músicas do Tidal. Por isso, no primeiro pause o driver testa automaticamente, uma a uma, as formas de pausar que o aparelho aceita, confere se a música realmente parou e guarda a forma que funcionou naquele aparelho. Dos pauses seguintes em diante ele usa direto a forma guardada, sem novo teste.
Em alguns modelos a única forma que funciona é a entrada nula (a mesma usada ao desligar, normalmente Line In): o aparelho é levado para essa entrada, o som para e a tela mostra o estado pausado. Ao tocar Play, a mesma faixa volta a tocar, do ponto em que parou quando o aparelho permite (senão, do início da faixa).
O primeiro pause em cada aparelho pode demorar alguns segundos (às vezes perto de meio minuto), por causa do teste. É normal e acontece só uma vez. Para funcionar com a entrada nula, Switch INPUT on turn OFF precisa apontar para uma entrada que exista no aparelho.
Busca no Tidal (artistas)
Coleção: playlists da conta
Tidal: conectar a conta do cliente
A conta é conectada pelo próprio cliente, na tela do Control4, sem acesso ao Composer.
- No Navigator, abra Tidal > Coleção > Conectar conta Tidal.
- Escaneie o QR code com o celular, ou acesse 4drivers.com.br/tidal e digite o código mostrado na tela.
- Faça login no Tidal no celular. Ao aparecer "Pronto!", volte ao Control4 e toque em Já fiz o login.
A conta continua conectada mesmo após atualizar o driver ou reiniciar o controlador. Para trocar de conta, use Desconectar conta Tidal no fim da Coleção, ou a ação Tidal - Disconnect Account no Composer.
Para tocar, o aparelho usa a conta Tidal conectada no aplicativo dele. Se uma lista não começar a tocar, o Control4 mostra "Tidal não iniciou no aparelho": confira a conta no aplicativo do aparelho.
Conexões e Multiroom
Conexões das entradas físicas do aparelho (quando existirem no modelo): Line In, Optical e HDMI.
As conexões LinkPlay Network 1, 2, 3... e Out To LinkPlays são usadas para o Control4 entender a distribuição de áudio entre os players pela rede. Ligue a saída Out To LinkPlays de um aparelho nas entradas LinkPlay Network dos outros que farão multiroom.
Não faça essas conexões quando os players forem embutidos no multiroom (matrizes de áudio) ou ligados nas entradas desses aparelhos.
Uma fonte ligada a um dos aparelhos (TV ou qualquer áudio) pode ser distribuída aos demais pela rede.
Aparelho que recebe a TV ou outra fonte distribuída: deixe Volume when Turns OFF em zero e Switch INPUT on turn OFF em No. Assim o cliente desliga esse ambiente e continua ouvindo nos demais.
Exibindo fontes nos ambientes
Deixe visíveis apenas os players do próprio aparelho (streaming, Bluetooth, USB), além de fontes convencionais ligadas a ele ou outros players.
Ações e comandos de programação
| Ação / comando | Descrição |
|---|---|
| Play Direct URL | Toca uma rádio direto pela URL do stream. As informações da mídia podem não vir e o aparelho pode manter a informação da mídia anterior; para contornar, chaveie o aparelho para alguma entrada, aguarde 2 s e então execute a URL. |
| Presets | Toca um preset do aparelho pela programação. |
| Show LinkPlay Configs | Lista as configurações do aparelho na aba Lua do Composer. |
| Voice ON / Voice OFF | Liga ou desliga os avisos de voz do aparelho. |
| Ch Select | Saída de canais (L, R). |
| Release All My Slaves | Libera todos os players agrupados a este. Bom para garantir que os aparelhos estejam independentes; pode virar um botão de "liberar todos". |
| Shuffle - Repeat | Modo de repetição e aleatório. |
| Eq | Apenas Bluetooth: modos de equalização. |
| Tidal - Disconnect Account | Desconecta a conta Tidal do driver. |
Exemplo de programação com Play Direct URL
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| Ambiente religa sozinho | Mantenha Auto Select Requires Play em Yes e confira a entrada nula. Com Debug Mode em Print, o log mostra o motivo de cada religamento. |
| Música continua tocando depois de desligar | Troque Switch INPUT on turn OFF para uma entrada que exista no aparelho (normalmente Line In). |
| Primeiro pause no Tidal demora | Normal: no primeiro pause o driver testa a forma de pausar do aparelho. Depois disso a pausa é imediata. |
| "Tidal não iniciou no aparelho" | Conta Tidal não conectada (ou conectada errada) no aplicativo do aparelho. |
| Coleção pede para conectar | Conecte a conta do cliente em Tidal > Coleção. |
| Connection Status desconectado | IP do aparelho, rede, http-https (WiiM usa https) e Protocol. |
Para suporte, ligue Debug Mode = Print, reproduza o problema e envie o log para a 4Drivers.
Histórico
| Versão | Mudanças |
|---|---|
| 1155 (04/11/2026) | Novos recursos: TuneIn embarcado no driver (navegação, busca e Favoritos compartilháveis entre os aparelhos LinkPlay do projeto); Tidal embarcado (busca, página do artista, Coleção da conta com login pela tela via QR code, salvar a fila como playlist, capa e nome da faixa no Tocando agora); abas do Navigator configuráveis (Presets, TuneIn, Tidal); ligar o ambiente só quando o aparelho realmente começa a tocar, com bloqueio após desligar; desligar confirma que o aparelho parou; documentação em HTML. |
| 1120 (20/12/2025) | Comando Play Direct URL. |
| 1115 (08/10/2025) | Barra de progresso e correção do chaveamento automático. |
| 1111 (28/06/2025) | Renomeia o driver ao ser instalado. |
| 1110 (21/05/2025) | Reformulação de ids (veja a nota de atualização). |
| 1091 (19/03/2025) | Ajustes em chaveamentos automáticos. |
| 1085 (01/12/2024) | Scan Devices e Presets na interface. |
| 1067 (08/04/2024) | Ajuste em agrupamento de ambientes. |
| 1060 (25/12/2023) | Propriedade AutoOff. |
| 1052 (23/11/2023) | Compatibilidade com https para WiiM. |
| 1051 (23/01/2023) | Ajustes em validação para OS 2. |
| 1024 (03/07/2022) | Correção em modo Multiroom. |
| 1023 (18/06/2022) | Voice OFF ao iniciar; ajuste em AirPlay. |
| 1022 (11/06/2022) | Iniciar ambiente com AirPlay. |
| 1020 (02/06/2022) | Versão inicial. |
Nota de atualização (versões anteriores a 1110)
Na versão 1100 os ids internos de conexão foram normalizados. As conexões de entradas e de multiroom entre aparelhos se perdem na atualização e precisam ser refeitas: anote as conexões antes de atualizar e reconecte depois.