Ajuda

Para que serve o MusicBee UPnP Plugin

Um plugin de código aberto para MusicBee que conecta sua biblioteca aos dispositivos UPnP/DLNA em sua rede doméstica — telefones, smart TVs, streamers de alta fidelidade, alto-falantes em rede — sem nuvem e sem login. É um fork do plugin UPnP original de Steven Mayall, reconstruído para tornar uma biblioteca grande e variada agradável de navegar a partir de outro dispositivo.

Duas coisas diferenciam este fork de um servidor UPnP comum, e são a razão para escolhê-lo:

• Ele publica o todo do MusicBee — não apenas "Música". Seus Filtros, Podcasts, Audiolivros, estações de Rádio, a Caixa de Entrada e suas Listas de Reprodução aparecem como seus próprios contêineres navegáveis no outro dispositivo, ao lado da música. A maioria dos servidores mostra uma biblioteca de música plana e nada mais.
• Cada um desses nós pode ser mostrado, ocultado e moldado individualmente. Você decide quais nós um dispositivo vê e dá a cada um seu próprio caminho de descoberta — a rota pela qual você o explora (Artista do Álbum → Álbum → Faixas, uma lista de faixas plana, por Gênero, por Ano…). Uma biblioteca de 300.000 faixas acaba sendo navegada como uma bem organizada, em vez de um despejo de dados plano.

Por trás dessas duas ideias principais, o plugin é organizado em torno de um fato estrutural: o MusicBee pode desempenhar três funções de rede diferentes, e cada tela na caixa de diálogo de configurações pertence a uma delas. Entenda as três funções e o resto da caixa de diálogo se explica:

• Servidor — outros dispositivos navegam na biblioteca do MusicBee e puxam faixas dela. É aqui que as duas características principais mencionadas acima residem.
• Renderizador — o MusicBee se torna um alvo para o qual outros aplicativos podem reproduzir, como um alto-falante de rede.
• Ponto de controle — o MusicBee reproduz seu próprio áudio para fora para um alto-falante ou streamer remoto.

Você pode usar uma função ou todas as três. Ative apenas o que você precisa. Ao longo deste guia, cada configuração é explicada ao lado do recurso ao qual pertence — não há uma lista separada de "configurações" para consulta cruzada.

Instalação

1. Baixe mb_UPnP_yaiol.dll na página de lançamento.
2. Copie-o para a pasta de plugins do MusicBee, geralmente C:\Users\<você>\AppData\Roaming\MusicBee\Plugins\.
3. Reinicie o MusicBee.
4. Abra Editar → Preferências → Plugins, encontre MusicBee UPnP Plugin e clique em Configurar.

A DLL yaiol tem um nome de arquivo distinto, então pode coexistir e rodar junto com o plugin original sem conflito.

Servidor — outros navegam na sua biblioteca

UPnP é um protocolo para dispositivos de áudio se encontrarem e se controlarem em uma rede local, e dentro dele cada participante desempenha uma função definida. Com a função Servidor ativada (o interruptor Servidor UPnP), o MusicBee desempenha a função de Servidor de Mídia: ele responde a solicitações de descoberta na sua LAN e serve sua biblioteca a qualquer dispositivo que solicite. No outro dispositivo, você vê uma árvore de mídia e toca para reproduzir; o áudio é transmitido do servidor HTTP integrado do MusicBee diretamente para o dispositivo. O MusicBee é apenas a fonte — o outro dispositivo está no comando.

Por que você o usaria. Ele transforma o único PC que contém toda a sua coleção em uma fonte de rede que todos os outros gadgets podem acessar, sem copiar arquivos ou fazer login em nada. Esta é a metade do plugin em que o fork mais investe, e é onde as duas principais funcionalidades residem — o que você publica (abaixo) e como cada nó é moldado.

Quando desativá-lo. Apenas se você nunca navegar no MusicBee a partir de outro dispositivo. A função é independente das outras duas; você pode servir a biblioteca e ainda deixar as funções de renderizador e ponto de controle desativadas.

Algumas configurações de todo o servidor ficam ao lado do interruptor: o nome do servidor que outros dispositivos mostram em sua lista, a interface de rede e porta às quais o MusicBee se vincula (veja Encontrando-se na rede), e um limite de conexões máximas sobre quantos fluxos simultâneos o servidor atenderá de uma vez.

Configurações

Controle	O que ele faz
Servidor UPnP: Permitir que dispositivos UPnP naveguem e reproduzam da biblioteca do MusicBee	Interruptor mestre para a função Servidor — permite que dispositivos UPnP naveguem e reproduzam da biblioteca do MusicBee.
Nome do servidor	O nome que outros dispositivos mostram para o MusicBee quando o descobrem.
Máx. conexões	Máximo de fluxos de arquivo simultâneos que o servidor atenderá (padrão 16, intervalo 1–256). Aumente-o se um dispositivo disparando muitas solicitações paralelas acionar o emblema ⚠ Max Conn. Entra em vigor após uma reinicialização.
Atualizar estatísticas de reprodução no MusicBee	Conta as faixas reproduzidas via UPnP para as contagens de reprodução e carimbos de data/hora da última reprodução do MusicBee.

Publicar todo o MusicBee, não apenas Música

Esta é a primeira das duas características principais do fork. Um servidor UPnP comum entrega à rede uma única biblioteca "Música" plana. Este exibe cada área de conteúdo que o MusicBee organiza, cada uma como seu próprio contêiner de nível superior no dispositivo de navegação.

As sete coisas que o MusicBee pode publicar

Quando um dispositivo navega no MusicBee, a raiz em que ele aterrissa pode oferecer todos estes, lado a lado:

• Música — sua biblioteca principal, moldada como você preferir (veja caminhos de descoberta abaixo).
• Filtros — as abas de filtro que você já usa na parte superior da visualização principal do MusicBee (Music, ALL, FAV, um filtro de Jazz, um filtro de Clássica, o que quer que você tenha configurado) aparecem como pontos de entrada, espelhando como você já pensa sobre sua biblioteca. Os filtros são lidos ao vivo dos mesmos arquivos que o próprio MusicBee usa, então eles permanecem sincronizados sem configuração.
• Podcasts — suas assinaturas de podcast, cada uma abrindo para seus episódios, com a arte da assinatura sendo transmitida.
• Audiolivros — a categoria Audiolivros do MusicBee.
• Rádio — suas estações de rádio da internet salvas.
• Caixa de Entrada — a Caixa de Entrada do MusicBee de faixas recém-adicionadas e ainda não arquivadas.
• Listas de Reprodução — suas listas de reprodução do MusicBee.

Como estes vêm diretamente do MusicBee, eles não precisam de configuração separada — assine um podcast ou adicione uma estação no MusicBee e ela estará acessível da rede na próxima vez que o dispositivo navegar. Se cada um realmente aparece, e a forma que assume, é trabalho da próxima característica.

Por padrão, Filtros e Playlists ficam dentro de uma pasta organizadora própria. Se cada fonte realmente aparece, onde ela fica — incluindo fixar as que você mais usa no topo da raiz de navegação, agrupadas por tipo — e a forma que ela assume são todos decididos por nó pelo próximo recurso.

Versões anteriores desta ajuda listavam "nenhum contêiner raiz de podcast" como uma limitação. Isso não é mais verdade — podcasts são publicados como todas as outras fontes.

Mostrar, ocultar e moldar cada nó

Este é o segundo recurso principal, e o que dá o nome ao fork. Publicar sete fontes seria barulho se você não pudesse controlá-las — então cada nó exposto é independentemente comutável, fixável à raiz e carrega seu próprio caminho de descoberta.

Você gerencia tudo isso na guia Visualizar da caixa de diálogo de configurações, que mostra toda a árvore exposta como uma lista de verificação. O padrão é sempre o mesmo: marque os nós nos quais você deseja atuar, então use os controles ao lado da árvore para configurá-los todos de uma vez — torná-los visíveis ou ocultos, fixá-los no topo da árvore ou aplicar um modelo de caminho. Assim, você pode expor Música, Filtros e Listas de Reprodução, ocultar a Caixa de Entrada e Rádio, fixar seu filtro Jazz na raiz e dar aos Podcasts uma forma por assinatura — cada um independentemente.

Mostrar, ocultar e fixar cada nó

Dois interruptores decidem se e onde um nó aparece, independentemente de como ele é formatado. Ambos estão na aba Visualizar como caixas de seleção de três estados que atuam em cada nó que você marcou na árvore:

• Visível — se os dispositivos veem o nó. Desmarque-o para ocultar um nó; ele permanece na sua biblioteca, simplesmente para de ser anunciado. (Como ele age no conjunto marcado, a caixa de seleção mostra um estado "misto" sombreado quando sua seleção está parcialmente visível, parcialmente oculta.) Nós ocultos ficam acinzentados na árvore — e uma pasta fica acinzentada quando todos os nós dentro dela estão ocultos — então um olhar rápido informa o que ainda está exposto.
• Nível superior — se o nó também está fixado no topo da raiz de navegação. A fixação é aditiva: o nó ainda aparece em sua pasta invólucro usual e ganha uma cópia perto do topo da raiz, agrupado com seu próprio tipo — um filtro fixado fica diretamente abaixo da pasta Filtros, uma playlist fixada diretamente abaixo da pasta Playlists — para que seus atalhos permaneçam ao lado das coisas a que pertencem. Nós fixados são sinalizados com um ★ na caixa de diálogo para que você possa ver rapidamente quais foram elevados.

Quando um filtro ou playlist é fixado na raiz, pode ser difícil distingui-lo de uma fonte normal de nível superior, então você pode adicionar um prefixo curto ao seu nome exibido (definido na aba Opções da Biblioteca). O prefixo é literal — o que você digitar é colocado na frente do nome literalmente, então inclua seu próprio espaço final se desejar.

Exemplo prático. Você navega principalmente pelo seu filtro Jazz e pela sua playlist Friday Night, ambos atualmente aninhados dentro das pastas Filters e Playlists invólucro.

Você marca ambos os nós na árvore de visualização e clica em Top level. Cada um agora mostra um ★ na caixa de diálogo. No dispositivo de navegação, eles ainda aparecem dentro de suas pastas invólucro como antes, mas também ganham uma cópia no topo da raiz, cada um ao lado de seu próprio tipo: o filtro Jazz fixado fica diretamente abaixo da pasta Filters e a playlist Friday Night fixada diretamente abaixo da pasta Playlists. Com o prefixo do filtro definido como Filter: e o prefixo da playlist como Playlist: , as duas cópias fixadas exibem Filter: Jazz e Playlist: Friday Night — distintas de suas cópias dentro das pastas invólucro, e cada uma ao lado da pasta de seu próprio tipo. Desmarque Top level para qualquer um deles e sua cópia fixada desaparece, deixando a cópia da pasta invólucro intocada.

Isso substitui os antigos interruptores globais "expor filtros na raiz" / "expor playlists na raiz": a fixação agora é uma escolha que você faz nó por nó, para qualquer fonte, não um alternador de tudo ou nada para filtros e playlists.

Configurações

Control	O que ele faz
Visível	Mostra ou oculta cada nó marcado. Nós ocultos permanecem na sua biblioteca, mas não são anunciados aos dispositivos. Estado "misto" sombreado quando a seleção está parcialmente visível.
Nível superior	Também fixa cada nó marcado no topo da raiz de navegação, agrupado com seu tipo — filtros fixados abaixo da pasta Filtros, playlists fixadas abaixo da pasta Playlists (aditivo — o nó também mantém seu lugar normal). Nós fixados mostram um ★ na caixa de diálogo.
Prefixo do filtro (quando na raiz)	Um prefixo de texto literal colocado na frente do nome de um filtro quando ele é fixado na raiz (ajuda as cópias fixadas a se agruparem).
Prefixo da playlist (quando na raiz)	Um prefixo de texto literal colocado na frente do nome de uma playlist quando ela é fixada na raiz.

Caminhos de descoberta — a rota de detalhamento de cada nó

Um caminho de descoberta é a rota que um navegador percorre dentro de um nó. O mesmo nó pode ser apresentado como Artista do Álbum → Álbum → Faixas, ou como uma única lista de faixas plana, ou agrupado por Gênero e depois Artista, ou por Ano. Um caminho é construído a partir de um ou mais níveis (o campo pelo qual cada nível agrupa) terminando em uma folha (o que o nível mais profundo mostra — álbuns e suas faixas, ou uma lista de faixas plana). Um nó pode até carregar vários caminhos de uma vez, oferecendo mais de uma forma de acesso.

Conteúdos diferentes exigem formas diferentes, e a forma errada torna um nó inutilizável. Música exige agrupamento por artista do álbum; uma playlist exige uma lista ordenada plana; podcasts exigem suas assinaturas. Cada nó obtém a resposta certa porque cada um possui seu próprio caminho.

Exemplo prático. Você tem um filtro de Jazz com 5.000 faixas e uma playlist "Friday Night" com 30 faixas, ambos expostos.

• Para o filtro de Jazz você aplica um modelo cujo caminho é Artista do Álbum → Álbum → Faixas. No dispositivo você detalha: artistas, depois os álbuns desse artista, depois as faixas do álbum na ordem de disco e faixa.
• Para a playlist você aplica o modelo Faixas Planas em vez disso. Ao abri-la, você obtém as 30 faixas na ordem da playlist, sem camada de artista ou álbum no meio — exatamente o que uma playlist deve ser.

Mesmo plugin, mesma caixa de diálogo, dois nós, duas formas completamente diferentes — porque o caminho é uma propriedade do nó, não uma configuração global. Você não pode prever o layout de um nó no dispositivo sem saber qual modelo ele carrega; é por isso que isso precisa ser explicado.

Um nó não apenas recebe uma cópia de um modelo — ele o segue. A árvore de Visualização mostra qual modelo cada nó segue, logo após o nome do nó, e editar um modelo na guia Caminhos imediatamente remodela cada nó que o segue — sem reaplicar nó por nó. Aplicar um modelo a um nó oculto também o torna visível novamente: aplicar é o gesto "mostre-me isso, com essa forma", enquanto ocultar permanece com a caixa de seleção Visível. Cada linha de modelo mostra uma contagem (n) ao vivo dos nós que o seguem, e um modelo só pode ser excluído enquanto essa contagem for zero — o botão de exclusão permanece desativado enquanto algo seguir o modelo, para que um nó nunca possa ser deixado órfão por uma exclusão. Para ver exatamente quais nós seguem um modelo, o botão de funil ao lado da árvore de Visualização filtra a árvore para apenas esses nós; selecionar outro modelo refiltra, e desativar o funil restaura a árvore completa. Excluir um modelo não utilizado também permanece agora — os padrões enviados não são mais recriados silenciosamente na próxima vez que o plugin é carregado.

Quando um caminho termina na folha Álbum → Faixas, você também decide o que conta como um álbum. Em vez de agrupar estritamente por título do álbum, você escolhe um ou mais campos — Álbum, Álbum de Classificação, Ano, Artista do Álbum — que juntos decidem quais faixas se fundem em um único álbum, como seu título é lido e a ordem em que os álbuns aparecem, cada campo classificável em ordem crescente ou decrescente. Adicionar Artista do Álbum mantém dois álbuns com o mesmo nome de artistas diferentes separados; adicionar Ano decrescente lista os álbuns de um artista do mais novo para o mais antigo. Quando você agrupa por ano, o MusicBee oferece dois campos que espelham os seus próprios — Ano, a tag de data completa (que pode conter uma data inteira como 2024-03-15), e Ano (aaaa), apenas o ano de quatro dígitos — então escolher Ano (aaaa) reúne todos os lançamentos de um ano em vez de dividi-los por data exata.

Os padrões são sensatos — novos filtros são moldados por artista do álbum, playlists e a Caixa de Entrada recebem padrões sensatos — então, para o caso comum, você não muda nada. Acesse a guia Visualização quando quiser que um nó específico seja moldado de forma diferente.

Configurações

Você cria modelos de caminho nomeados e reutilizáveis na guia Caminhos, e depois os aplica aos nós na guia Visualização.

Controle	O que ele faz
Aplicar aos Pontos de Extremidade Marcados	Faz com que cada nó que você marcou na árvore siga o modelo atualmente selecionado (e o reexpõe se estava oculto).
Expandir Tudo / Recolher Tudo	Expande ou recolhe toda a árvore de endpoints.
Mostrar apenas os nós que correspondem ao modelo selecionado	O botão de funil: filtra a árvore de endpoints para apenas os nós que seguem o modelo selecionado. Selecione outro modelo para refiltrar; desative para restaurar a árvore completa.
Modelo	O modelo de caminho nomeado que está sendo editado.
↑ / ↓	Move o modelo selecionado para cima ou para baixo na lista, para ordenar como seus modelos são apresentados.
Agrupar por	O(s) campo(s) pelo(s) qual(is) o nível agrupa (por exemplo, Artista do Álbum).
Folha	O que o nível mais profundo mostra.
Álbum → Faixas (AT)	Modo de folha: Álbum → Faixas — detalha álbuns para suas faixas.
Faixas Planas (T)	Modo de folha: Faixas Planas — uma única lista de faixas plana.
Incluir [Todas as Faixas] em cada nível	Adiciona um atalho [Todas as Faixas] em cada nível. Mostrado apenas no modo Álbum → Faixas.
Agrupar álbum por	Define o que conta como um álbum, como seu título é lido e a ordem em que os álbuns aparecem — escolha um ou mais campos (Álbum, Álbum de Classificação, Ano, Artista do Álbum…), cada um com sua própria alternância crescente/decrescente. Mostrado apenas no modo Álbum → Faixas.
Adicionar / Remover	Adiciona ou remove um caminho no modelo.

Caminhos são tipados para o nó ao qual se encaixam

Nem todo campo significa algo para todo tipo de nó. Uma estação de rádio não tem álbum ou ano; um episódio de podcast tem uma assinatura, uma pasta e uma data de publicação, mas não tem artista do álbum. Assim, cada caminho pertence a uma de três categorias — Padrão (sua música, filtros, audiolivros, caixa de entrada e playlists, que carregam tags completas), Rádio ou Podcast — e essa categoria decide duas coisas de uma vez: quais campos você pode agrupar e a quais nós o caminho pode ser aplicado.

Na aba Caminhos, a lista de modelos é desenhada em duas faixas: Padrão — onde seus próprios modelos residem e onde cada novo modelo é criado — e uma faixa Reservada contendo os modelos de Rádio e Podcasts. Enquanto você edita um modelo Padrão, o menu de campos oferece tudo; um modelo de Rádio oferece apenas os campos que uma estação realmente possui; um modelo de Podcast oferece apenas o que um episódio possui — sua pasta, sua assinatura e seu ano de publicação. Na aba Visualizar, aplicar um modelo apenas acende os nós aos quais ele se encaixa — os demais ficam cinzas e não podem ser marcados — então um caminho Padrão nunca pode ser aplicado aos nós de Rádio ou Podcasts.

Na verdade, você nunca aplica nada a Rádio ou Podcasts: cada um é permanentemente emparelhado com o modelo de sua categoria. Remodele o modelo de Rádio ou Podcasts na aba Caminhos e o nó segue por si só; com um modelo Reservado selecionado, o botão Aplicar é simplesmente desativado, porque não há nada para aplicar. Isso impede que você construa um caminho que silenciosamente não produz nada ao agrupar por um campo que o nó não pode preencher — e como um modelo seguido nunca pode ser excluído (veja Caminhos de descoberta acima), os modelos de Rádio e Podcasts estão sempre lá para serem remodelados.

Artistas arquivados pelo seu nome de ordenação

Dentro de qualquer nó de música, os artistas são agrupados e alfabetizados pela tag Sort Album Artist, não pelo nome de exibição. Esta é a parte que surpreende as pessoas, então aqui está exatamente o que acontece.

Exemplo prático. Suponha que uma faixa seja marcada:

• Artist = Bob Dylan
• Sort Album Artist = Dylan, Bob

Na árvore de navegação, Dylan é arquivado sob a letra D (de Dylan, Bob), não sob B (de Bob Dylan). A tag de ordenação impulsiona tanto o agrupamento quanto a posição alfabética, exatamente como um navegador de hi-fi ou uma loja de discos o arquivaria.

É automático e impulsionado inteiramente pelas suas tags MusicBee existentes — não há nada para configurar.

Tags de múltiplos valores se expandem

Quando o Album Artist (ou Genre) de uma faixa contém mais de um valor, a faixa aparece sob cada valor separadamente, em vez de inventar uma única entrada fundida.

Exemplo prático. O Album Artist de uma faixa contém dois valores: yaiol; Ars Ricercata. Essa faixa aparece sob ambos yaiol e Ars Ricercata — uma vez em cada ramificação do artista — em vez de sob um único artista falso "yaiol; Ars Ricercata". Tags de artista com múltiplos valores se expandem da mesma forma que tags de múltiplos gêneros.

Assim como o agrupamento por nome de ordenação, isso é automático e impulsionado por tags.

Agrupando listas longas pela primeira letra

Se um nível ficar muito longo para rolar confortavelmente em um telefone, ele pode agrupar pela primeira letra — inserir uma camada A, B, C, … acima das entradas para que você escolha uma letra primeiro. É configurado por campo dentro de um modelo, a partir do menu de contexto do campo: Split [field] by their first letter. Deixe-o desativado para listas curtas; ative-o para os níveis — geralmente artistas — onde a lista é enorme.

Navegar por uma tag como uma árvore aninhada

Algumas tags empacotam uma hierarquia em um único valor com um separador — uma tag de Agrupamento de Jazz/Cool Jazz, um gênero personalizado de Electronic/Ambient/Drone. Por padrão, toda essa string é uma entrada plana, então a estrutura que você codificou na tag é desperdiçada. Marque o campo como hierárquico e o plugin divide cada valor em um delimitador que você escolhe e o transforma em uma árvore de detalhamento — você escolhe Jazz, depois Cool Jazz, exatamente como a tag está escrita.

Você configura isso na aba Opções da Biblioteca: escolha um campo, digite o único caractere que separa seus níveis (por exemplo, /), e adicione-o à lista. Ele então se aplica onde quer que esse campo seja usado como um nível de agrupamento em qualquer caminho de descoberta. Faixas marcadas em um ramo em vez de uma folha — marcadas apenas Jazz, sem subgênero — aparecem sob uma entrada entre colchetes [Jazz] ao lado dos ramos mais profundos, para que nada seja oculto. Um ramo que contém apenas um filho colapsa automaticamente (a mesma regra de uma escolha como em todos os outros lugares), e ; não pode ser usado como delimitador — esse é o próprio separador de múltiplos valores do MusicBee, então um valor como Rock; Jazz/Cool Jazz é dividido nas duas tags primeiro, então cada uma é detalhada.

Exemplo prático. Suas faixas carregam uma tag de Agrupamento como Jazz/Cool Jazz, Jazz/Hard Bop e Classical/Baroque, e um caminho de descoberta que agrupa por Agrupamento. Plano, o nó lista três entradas longas. Marque Agrupamento hierárquico com /, e o mesmo nó agora abre para Jazz e Classical; abrir Jazz revela Cool Jazz e Hard Bop. Uma faixa marcada apenas Jazz aparece sob uma entrada [Jazz] ao lado delas. Você não pode prever esse layout apenas pela tag — ele depende inteiramente de qual campo você marcou e com qual delimitador — então vale a pena configurá-lo deliberadamente.

Configurações

Controle	O que ele faz
Campos hierárquicos	A lista de campos renderizados como uma árvore de detalhamento, cada um emparelhado com seu delimitador de um caractere. Escolha um campo, digite o separador (não ;), e adicione-o; o campo então detalha nível por nível onde quer que um caminho de descoberta agrupe por ele.

Níveis de uma única escolha colapsam automaticamente

Quando um nível de agrupamento tem apenas uma entrada para o que você está navegando, o plugin o pula em vez de fazer você abrir uma pasta que contém uma única pasta — você vai direto para a próxima escolha real. Não há nada para configurar; acontece automaticamente, em todos os caminhos.

Exemplo prático. Seu caminho agrupa por Record Type → Album → Tracks. Um artista que só lançou LPs faria você abrir uma única pasta Record Type → LP apenas para chegar aos álbuns. Em vez disso, abrir esse artista leva você diretamente aos álbuns — o nível redundante desaparece para esse artista, enquanto um artista com LPs e EPs ainda mostra a escolha de Record Type. Vários níveis de uma única entrada em sequência colapsam juntos, e um nível de primeira letra com apenas uma letra em jogo desaparece da mesma forma.

Miniaturas de álbuns na árvore de navegação

Os álbuns carregam suas obras de arte na resposta de navegação, para que os dispositivos que mostram miniaturas em suas listas realmente as exibam. (O plugin original anexava arte apenas a faixas individuais, então as listas de álbuns apareciam como texto simples.) Nada para configurar — ela simplesmente viaja com o álbum.

Pesquisar e embaralhar a partir do dispositivo

A maioria dos aplicativos de controle coloca uma caixa de pesquisa e uma pasta "aleatória" ou "embaralhar" ao lado da árvore de navegação. Ambos chegam ao MusicBee como o mesmo tipo de solicitação UPnP, e ambos são respondidos ao vivo da sua biblioteca, em vez de um índice pré-construído — assim, uma faixa que você retagou há um minuto é encontrada imediatamente.

A Pesquisa corresponde a título ou artista. Uma pesquisa por título examina o título da faixa quando seu aplicativo está pesquisando faixas e o título do álbum quando está pesquisando álbuns. Uma pesquisa por artista corresponde ao Artista da faixa ou ao Artista do Álbum do álbum, então uma compilação aparece se você digitar o nome do artista ou o nome sob o qual o álbum está arquivado. Os resultados são exibidos uma página por vez enquanto você rola, então um termo que corresponde a milhares de faixas permanece responsivo em vez de travar ou voltar aos primeiros resultados.

Exemplo prático. Você pesquisa por Blue na visualização de álbuns do seu aplicativo de controle. Você obtém os álbuns chamados Blue — Kind of Blue, Blue Train — e não todos os álbuns que por acaso contêm uma faixa chamada "Blue". Mude o aplicativo para a visualização de faixas e pesquise a mesma palavra e você obterá as faixas. Qual campo é correspondido segue o que seu aplicativo solicitou, não o que você digitou.

Pastas de embaralhamento — as entradas Faixas Aleatórias e Álbuns Aleatórios que alguns aplicativos mostram — são uma solicitação de uma fatia de tudo, sem um termo de pesquisa anexado. Por padrão, esse "tudo" é sua biblioteca de música inteira, o que raramente é o que você quer se metade dela for palavra falada ou material que você nunca embaralha. Reprodução aleatória de, na guia Opções da Biblioteca, permite que você aponte para um dos seus filtros do MusicBee, então cada solicitação aleatória extrai apenas do conteúdo desse filtro. Filtros ocultos também são oferecidos aqui — o escopo do embaralhamento não tem nada a ver com se você quer que esse filtro apareça na árvore de navegação. Abrir uma pasta de embaralhamento de dentro de um filtro no dispositivo ainda embaralha esse filtro: uma escolha explícita feita durante a navegação sempre prevalece sobre a configuração.

Configurações

Controle	O que ele faz
Reprodução aleatória de	De onde uma solicitação de embaralhamento do dispositivo é extraída — Toda a música (sua biblioteca inteira, o padrão) ou um filtro nomeado do MusicBee. Se o filtro escolhido for posteriormente excluído ou renomeado no MusicBee, a configuração retorna silenciosamente para a biblioteca inteira.

Adaptar o stream a cada dispositivo

A navegação é apenas metade do trabalho; o áudio ainda precisa ser reproduzido em hardware que varia muito no que aceita. Este recurso é como o MusicBee adapta cada stream — e é compartilhado: ele se aplica tanto quando a função Servidor serve uma faixa a um dispositivo de navegação, quanto quando a função Ponto de controle reproduz para um renderizador remoto. Dois conceitos o impulsionam: perfis de dispositivo (o que um dispositivo pode lidar) e a cadeia de precedência de transcodificação (se uma faixa é re-codificada ou não).

Perfis de dispositivo — adaptando-se a cada dispositivo

O hardware UPnP real é inconsistente quanto ao que aceita: um streamer quer FLAC de 24 bits, outro só reproduz PCM de 16 bits, um terceiro mente sobre quais codecs suporta. Um perfil de dispositivo é como você ensina ao plugin os limites e peculiaridades de um dispositivo.

Como um perfil é escolhido. Todo dispositivo se identifica com uma string User-Agent quando se conecta. Um perfil diz "aplique-me quando o user-agent contiver este fragmento." Quando um dispositivo se conecta, o plugin encontra o perfil correspondente; se nenhum corresponder, um perfil Dispositivo Genérico integrado é o fallback. Você pode listar vários fragmentos separados por | (por exemplo, Linn|ChorusDS|BubbleDS) para que um perfil cubra uma família de dispositivos relacionados.

O que um perfil controla. Os limites que um dispositivo não pode exceder — tamanho máximo de imagem para arte do álbum, faixa de taxa de amostragem permitida, profundidade de bits máxima, downmixing apenas para estéreo — além disso, quando uma faixa precisa de conversão, qual formato de saída e taxa de amostragem converter. Um grupo separado de chaves de "dispositivo problemático" contorna bugs de hardware específicos (manuseio de PCM bruto, ordem de bytes, cabeçalho HTTP content-length). Eles existem porque a conformidade UPnP na prática é irregular; a maioria das pessoas nunca os toca.

Quando tocar em um perfil. Somente quando um dispositivo específico se comporta mal. Fora da caixa, o perfil Genérico, mais os padrões por dispositivo enviados para hardware comum, cobrem a maioria dos casos. Para encontrar o user-agent de um dispositivo para que você possa direcioná-lo, ative o registro de depuração (consulte Diagnóstico), reproduza algo do dispositivo e leia a linha useragent= no log.

A chave mais importante do perfil — forçar fluxo nativo — não se trata de limites; ela decide se alguma das opções acima se aplica. Esse é o próximo conceito.

Configurações

Controle	O que faz
Nome	O nome de exibição do perfil.
Aplica-se quando o user-agent contém	O(s) fragmento(s) do user-agent que um dispositivo deve conter para corresponder a este perfil; separe alternativas com |. Dispositivos não correspondentes retornam ao perfil Genérico.
Tamanho máximo da imagem	Tamanho máximo de pixel da arte do álbum enviado para este dispositivo (160 px é o padrão DLNA; maior não é universalmente suportado).
Taxa de amostragem de saída / para	A faixa de taxa de amostragem que o dispositivo aceita; fontes fora dela são convertidas (força a transcodificação).
Canais / apenas estéreo	Downmix multi-canal para estéreo para dispositivos que só fazem dois canais.
Profundidade máxima de bits	Maior profundidade de bits que o dispositivo aceita; fontes mais profundas são convertidas.
Formato de saída	Quando uma transcodificação é necessária, o formato para converter (PCM, FLAC, MP3, AAC, Ogg).
Taxa de amostragem de saída	A taxa de amostragem a ser usada na transcodificação; "igual à fonte" preserva o original.
Não usar RAW PCM	Empacota PCM em um contêiner WAV em vez de enviar L16/L24 bruto. Para dispositivos que distorcem PCM bruto (alguns Marantz).
Forçar little endian para fluxos PCM	Envia PCM little-endian em vez do big-endian da especificação. Cura a reprodução de ruído branco em dispositivos que esperam little-endian.
Comprimento do conteúdo	Como preencher o cabeçalho HTTP Content-Length: Padrão (valor correto), Nenhum (omitir), Somente PCM ou Fixo (um valor "enorme" sentinela). Para dispositivos que manipulam mal o cabeçalho.

Transcodificar ou não — a cadeia de precedência

"Transcodificação" significa recodificar uma faixa em tempo real — para um formato que o dispositivo possa reproduzir, ou para que o EQ e o nivelamento de volume do MusicBee possam ser aplicados. O plugin prefere não transcodificar (enviar o arquivo original é mais rápido e sem perdas), então ele segue uma cadeia fixa de regras para decidir. Regras de nível superior vencem e silenciosamente substituem as de nível inferior. Esta é a parte mais incompreendida do plugin, porque várias configurações parecem que deveriam cooperar e não cooperam.

Prioridade	Regra	Efeito
1 (mais alta)	Forçar transcodificação (por perfil de dispositivo)	Sempre transcodificar. Substitui tudo abaixo. Mutuamente exclusiva com forçar nativo — marcar uma desmarca a outra.
2	Forçar stream nativo (por perfil de dispositivo, padrão LIGADO)	Nunca transcodificar para este dispositivo. Suprime as regras 3–5 inteiramente — envia os bytes originais independentemente do formato, efeitos ou limites.
3	EQ/DSP e ReplayGain (Biblioteca)	Forçar transcodificação para que o áudio possa ser processado. Ignorado silenciosamente se a regra 2 vencer.
4	Taxa de amostragem / profundidade de bits / somente estéreo (perfil de dispositivo)	Fonte fora do alcance → transcodificar para ajustar. Ignorado silenciosamente se a regra 2 vencer.
5 (mais baixa)	Suporte a codec (perfil de dispositivo)	Codec de origem que o dispositivo não consegue reproduzir → transcodificar para o formato de saída do perfil. Ignorado silenciosamente se a regra 2 vencer.

Como forçar stream nativo é LIGADO por padrão para cada perfil, o comportamento padrão é: entregar ao dispositivo o arquivo original e não fazer mais nada. Isso está exatamente certo para um dispositivo moderno em uma boa rede — mas significa que os efeitos da Biblioteca e os limites de áudio do perfil parecem "não fazer nada" até que você altere a regra 2.

Exemplo prático. Você quer que o nivelamento de volume ReplayGain do MusicBee seja aplicado ao seu streamer. Você marca Nivelar o volume de reprodução usando o modo replay gain ativo no MusicBee em Biblioteca. Você reproduz uma faixa — e o volume não é nivelado de forma alguma.

Por quê: o perfil do streamer ainda tem forçar stream nativo LIGADO (regra 2). A regra 2 tem precedência sobre a regra ReplayGain (regra 3), então o plugin envia o arquivo intocado e sua configuração de ReplayGain é silenciosamente ignorada.

A solução: abra o perfil desse dispositivo e desmarque forçar stream nativo. Como forçar nativo é por perfil, você pode deixá-lo ligado para o seu DAC hi-fi bit-perfect e desligado para o alto-falante portátil que precisa de ReplayGain — cada dispositivo obtém a resposta certa.

Regras práticas:

• Quer que EQ/DSP ou ReplayGain se apliquem a um dispositivo? Desligue forçar stream nativo no perfil desse dispositivo.
• Quer garantir uma nova transcodificação (para testes, ou para um dispositivo que engasga com arquivos nativos)? Marque forçar transcodificação no seu perfil — ela tem precedência sobre tudo.
• Caso contrário, deixe forçar stream nativo ligado. É a configuração de maior impacto no plugin e o padrão está certo para a maioria dos equipamentos modernos.

Configurações

Controle	O que faz
Forçar fluxo nativo (ignorar transcodificador)	Envia os bytes do arquivo original, ignorando o transcodificador, efeitos, ReplayGain e os limites de áudio do perfil. Padrão LIGADO. A configuração de reprodução de maior impacto; regra 2 da cadeia acima.
Forçar transcodificação (mutuamente exclusivo com forçar fluxo nativo)	Força cada stream para este dispositivo através do transcodificador. Tem precedência sobre forçar nativo; os dois são mutuamente exclusivos (marcar um desmarca o outro). Regra 1.
Usar o equalizador e efeitos DSP ativos no MusicBee [força a transcodificação]	Aplica o equalizador e os efeitos DSP do MusicBee ao áudio de saída. Força a transcodificação (regra 3), e é suprimido em qualquer dispositivo cujo perfil tenha forçar nativo ligado.
Nivelar o volume de reprodução usando o modo replay gain ativo no MusicBee [força a transcodificação]	Aplica o nivelamento de volume ReplayGain do MusicBee. Força a transcodificação (regra 3), e é suprimido em qualquer dispositivo cujo perfil tenha forçar nativo ligado.
Forçar fluxo nativo para rádio (ignorar transcodificador para estações)	Envia fontes de rádio/stream intocadas, ignorando o transcodificador especificamente para estações.

Renderizador — MusicBee como um destino de reprodução

Com a função de Renderizador ativada (o interruptor UPnP Renderizador), o MusicBee informa à rede "Eu sou um dispositivo para o qual você pode reproduzir". Um aplicativo de ponto de controle separado — um controle remoto de telefone, outro controlador de mídia — pode então selecionar o MusicBee e enviar áudio para ele reproduzir neste PC. Você dá ao destino um nome de renderizador amigável para que seja reconhecível na lista do outro aplicativo.

O que ele pode reproduzir. Ambos os tipos de faixa que um aplicativo controlador pode enviar. Se a faixa vier da própria biblioteca do MusicBee — você navegou pela biblioteca deste PC em seu telefone e tocou em uma música — o MusicBee reproduz o arquivo diretamente de seu próprio disco, intocado, sem nenhuma perda de qualidade que uma viagem de ida e volta pela rede poderia introduzir. Se a faixa estiver em qualquer outro lugar — um arquivo armazenado no próprio telefone, um NAS, outro servidor de mídia — o MusicBee a busca e a reproduz aqui.

Uma faixa enviada de outro lugar é copiada primeiro, e por que isso importa. Para uma faixa que não está em sua biblioteca, o MusicBee baixa silenciosamente uma cópia para uma pasta temporária e a reproduz, em vez de ouvi-la pela rede enquanto ela é transmitida. Ele precisa fazer isso: qualquer coisa que o MusicBee trate como um fluxo de rede ao vivo pode ser iniciada e parada, mas não navegada, então pular para um ponto diferente na música seria impossível, e a faixa seria exibida como um endereço web simples em vez de seu título. Reproduzir um arquivo real em seu próprio disco evita ambos. A cópia leva cerca de um segundo em uma rede doméstica. Algumas são mantidas lado a lado — a que está tocando, a próxima na fila e uma atrás para que pular para trás seja instantâneo — e as mais antigas são excluídas à medida que novas faixas chegam; qualquer coisa que sobrar é limpa na próxima vez que o MusicBee iniciar. O comprimento da faixa não é um obstáculo: um arquivo DSD ou de alta resolução longo é buscado como qualquer outro.

Rádio da internet é reconhecido e deixado em paz. Uma transmissão ao vivo nunca é copiada, porque não tem fim para baixar e não há nada para pular de qualquer maneira — o MusicBee simplesmente a reproduz como o fluxo que é. O aplicativo controlador diz qual dos dois está enviando, então isso não requer nenhuma configuração ou adivinhação de sua parte. O mesmo se aplica se uma cópia não puder ser buscada por qualquer outro motivo: a reprodução continua pela rede, e só então o título e o controle deslizante de posição se tornam não confiáveis.

Álbuns são reproduzidos sem interrupções. Quando o aplicativo controlador informa ao MusicBee o que vem a seguir — a maioria faz isso — essa faixa é buscada enquanto a atual ainda está tocando, e o próprio player do MusicBee cruza a fronteira. Assim, uma gravação ao vivo, um set de DJ ou uma obra clássica contínua enviada de um telefone é reproduzida como deveria, em vez de pausar em cada faixa.

Por que você o usaria. Ele permite que um telefone ou tablet use este PC como um alto-falante UPnP — útil quando o PC está conectado aos bons alto-falantes e você quer controlá-lo do sofá, quer a música esteja no PC ou no telefone em sua mão.

Quando desativá-lo. Deixe-o desativado, a menos que você queira especificamente enviar áudio para este PC de outro aplicativo. Com ele desativado, o MusicBee não aparecerá como um destino em nenhum lugar, o que geralmente é o que você deseja.

Use um aplicativo controlador por vez. O UPnP não tem a noção de um aplicativo "possuindo" um renderizador: qualquer aplicativo na rede pode enviar faixas para o MusicBee, e qualquer aplicativo observando pode reagir ao que vê. Portanto, se dois players estiverem apontados para o MusicBee ao mesmo tempo, você terá um comportamento que parece um bug e não é. Um segundo aplicativo que ainda tem o MusicBee selecionado continua observando, vê a faixa que enviou parar, conclui que sua música terminou e, utilmente, envia a próxima de sua fila — então a música salta repentinamente para um álbum diferente, ou pressionar próximo em um aplicativo inicia uma música no outro. Parar a reprodução no segundo aplicativo não é suficiente, porque ele permanece selecionado e continua observando. Aponte-o de volta para o próprio alto-falante do telefone, para outro dispositivo, ou feche-o corretamente.

Nota sobre maturidade. O renderizador é mais recente do que a função de servidor e teve menos testes em hardware real. Se um aplicativo controlador específico o acionar de forma estranha, é útil relatar.

Configurações

Controle	O que ele faz
Renderizador UPnP : Permitir que outros aplicativos reproduzam no MusicBee	Interruptor principal para a função de Renderizador — permite que outros aplicativos reproduzam para o MusicBee. Entra em vigor após uma reinicialização do MusicBee.
Nome do renderizador	O nome que este PC anuncia como renderizador, mostrado nas listas de dispositivos de outros aplicativos.

Ponto de controle — reproduzir em um alto-falante remoto

Com a função de Ponto de controle ativada (o interruptor UPnP Control Point), os renderizadores UPnP/DLNA da rede aparecem como dispositivos de saída dentro do MusicBee — o mesmo lugar onde você escolhe sua placa de som. Escolha um, pressione Reproduzir, e o MusicBee transmite o áudio para aquele alto-falante ou streamer remoto enquanto você continua usando a própria interface do MusicBee como controle remoto.

Por que você o usaria. Ele faz com que um streamer de alta fidelidade ou alto-falante em rede se comporte como apenas mais uma saída do MusicBee, sem software extra entre eles.

Quando desativá-lo. Deixe-o desativado se você sempre reproduzir apenas pelos próprios alto-falantes deste PC.

Duas coisas moldam o comportamento desta função. A primeira é a reprodução sem interrupções (abaixo). A segunda é Adaptar o fluxo a cada dispositivo — os mesmos perfis de dispositivo e precedência de transcodificação que governam o servidor também se aplicam aqui, já que o plugin está novamente alimentando áudio para um dispositivo remoto. O ponto de controle também reutiliza o servidor HTTP do MusicBee para enviar o áudio, então a porta do servidor e as regras de firewall importam aqui, mesmo que você nunca ative a função de Servidor.

Configurações

Controle	O que ele faz
Ponto de Controle UPnP : Adicionar renderizadores UPnP/DLNA de rede como dispositivos de saída do MusicBee	Interruptor mestre para a função de Ponto de controle — adiciona renderizadores UPnP/DLNA de rede como dispositivos de saída do MusicBee.

Reprodução sem interrupções — dois mecanismos diferentes

Algumas músicas são feitas para serem reproduzidas sem interrupções — álbuns ao vivo, movimentos clássicos, sets de DJ, álbuns conceituais. Meio segundo de silêncio entre as faixas as arruína. O plugin oferece duas maneiras de remover essa lacuna, e elas funcionam de maneiras muito diferentes.

Verdadeiramente sem interrupções (NextURI). Quando um renderizador diz que o suporta, o plugin pré-carrega a próxima faixa no dispositivo antes que a atual termine, de modo que o dispositivo cruza o limite internamente sem silêncio — como um CD player. Este é o mecanismo preferido: cada faixa mantém seus próprios metadados, a busca e o salto ainda funcionam, e não há nada para ativar — o plugin o usa automaticamente em dispositivos capazes. Por dispositivo, você pode desativá-lo (para hardware cuja implementação é problemática) ou dizer ao plugin para não limpar a faixa enfileirada quando a lista esvaziar (uma solução alternativa para dispositivos que tratam uma fila vazia como "parar").

Fluxo contínuo. O fallback mais antigo concatena tudo em um fluxo contínuo. Ele garante que não haja lacunas em qualquer dispositivo — mas a um custo real: o renderizador mostra as informações da primeira faixa para toda a sessão, os controles "próximo/anterior" param de funcionar e, como tudo está fundido em um único fluxo, tudo deve ser transcodificado (o force-native não pode ser aplicado). O rótulo na tela explica a compensação.

Qual usar. Prefira o verdadeiro sem interrupções — é automático e sem perdas. Recorra ao fluxo contínuo apenas para um dispositivo que não consegue fazer NextURI e onde as lacunas realmente o incomodam, aceitando que você perde metadados por faixa e controles de transporte. Os dois são mutuamente exclusivos: ativar o fluxo contínuo desativa o NextURI, para que você não possa executar ambos acidentalmente.

Configurações

Controle	O que ele faz
Habilitar reprodução sem pausas (NextURI) para este dispositivo	Habilita a reprodução verdadeiramente sem interrupções (NextURI) para este dispositivo. Ativado para dispositivos capazes; desative se a implementação do dispositivo for problemática.
Não enviar NextURI em branco quando a fila esvaziar	Impede que o plugin envie um NextURI em branco quando a fila esvazia — uma solução alternativa para dispositivos (por exemplo, Denon) que tratam isso como "parar".
Saída como um fluxo contínuo	Envia um fluxo concatenado contínuo em vez de faixas discretas. Remove lacunas em qualquer dispositivo, mas o renderizador mostra apenas as informações da primeira faixa, os controles de transporte param de funcionar e tudo é transcodificado. Desativa o NextURI enquanto ativado.

Encontrando-se na rede

Antes que qualquer uma das funções possa funcionar, os dispositivos precisam encontrar-se. O servidor do MusicBee se vincula a um endereço de rede e a uma porta TCP, então se anuncia na LAN via SSDP para que os dispositivos possam descobri-lo. A porta padrão é 9779; se essa porta já estiver ocupada, o plugin seleciona automaticamente uma porta livre próxima e os dispositivos ainda a descobrem (você só precisa definir uma porta fixa se sua configuração exigir uma).

Duas configurações importam em máquinas com rede incomum:

• Endereço IP / interface de rede. "Automático" serve em todas as interfaces, o que é correto para a maioria dos PCs. Em uma máquina com várias redes ao mesmo tempo — Wi-Fi e Ethernet e uma VPN — escolha a interface em que seus dispositivos de áudio realmente estão, para que o MusicBee anuncie um endereço que eles possam alcançar.
• Porta. Altere-a apenas se outro programa já usar o padrão, ou se seu firewall insistir em um número específico.

A principal razão pela qual um dispositivo "não consegue ver o MusicBee" é o firewall, não o UPnP. O Firewall do Windows deve permitir a porta do MusicBee em ambos os perfis de rede privado e público, e você geralmente precisa reiniciar o MusicBee após alterar as regras do firewall. Verifique isso antes de alterar qualquer coisa dentro do plugin.

Configurações

Controle	O que ele faz
Endereço IP	Qual interface de rede o servidor se vincula; "Automático" usa todas as interfaces. Entra em vigor após uma reinicialização do MusicBee.
porta	A porta TCP na qual o servidor HTTP escuta (padrão 9779). Se a porta estiver ocupada, o plugin seleciona automaticamente uma livre. Entra em vigor após uma reinicialização.

Diagnóstico

Quando um dispositivo específico se comporta mal, o comportamento do plugin é invisível até que você o registre. Essas ferramentas servem a todas as funções, então elas ficam em sua própria guia Depuração em vez de sob um recurso.

• Registrar informações de depuração registra cada solicitação, o user-agent do dispositivo e cada decisão de codec/transcodificação em um arquivo de log que você pode abrir com Visualizar. Ative-o durante a solução de problemas (e para descobrir o user-agent de um dispositivo para um perfil), depois desative-o novamente — o log cresce rapidamente. Você também pode limpá-lo a cada inicialização.
• A rede tem largura de banda limitada (Reprodução) informa ao plugin que, sempre que fizer uma transcodificação, ele deve usar a saída com perdas (MP3/AAC/Ogg) do perfil do dispositivo, em vez de uma grande sem perdas. Ative-o para links Wi-Fi lentos.
• A guia Depuração também contém ferramentas de consulta de baixo nível destinadas ao desenvolvimento; você pode ignorá-las no uso normal (consulte Outras configurações).

Para o diagnóstico diário, o padrão é: habilitar o registro → reproduzir o problema → ler o log → ajustar o perfil do dispositivo relevante → desabilitar o registro.

Configurações

Controle	O que ele faz
Registrar informações de depuração	Registra cada solicitação, user-agent e decisão de codec em um arquivo. Ativado durante a solução de problemas, desativado caso contrário.
Limpar log na inicialização do plugin	Esvazia o log cada vez que o plugin inicia.
Visualizar	Abre o arquivo de log atual.
Limpar log	Limpa o log agora.
A rede tem largura de banda limitada - transcodificar a saída para o formato com perdas definido no perfil do dispositivo acima	Quando ocorre uma transcodificação, usa o formato de saída com perdas do perfil do dispositivo. Para links lentos. Requer um formato com perdas escolhido na seção de transcodificação do perfil.

Solução rápida de problemas

Sintoma	Primeira coisa a tentar
Um dispositivo não vê o MusicBee de forma alguma	Verifique o Firewall do Windows para ambas as redes privada e pública; a porta do plugin (9779 por padrão) deve estar acessível. Reinicie o MusicBee após as alterações no firewall.
Uma fonte (Podcasts, Rádio, Caixa de Entrada…) está faltando na árvore	Provavelmente está oculta. Na guia Visualizar, marque o nó e certifique-se de que sua caixa de seleção Visível esteja ativada.
Um nó navega com o formato errado	Aplique um caminho de descoberta diferente na guia Visualizar — por exemplo, Faixas Planas para uma playlist, Artista do Álbum → Álbum → Faixas para um filtro de música.
O dispositivo vê o MusicBee, mas não reproduz nenhuma faixa	O perfil do dispositivo provavelmente está errado, ou a transmissão nativa forçada está desativada e uma transcodificação está falhando. Marque forçar fluxo nativo no perfil desse dispositivo e tente novamente.
O áudio é reproduzido como estática / ruído branco	Tente forçar little endian para fluxos PCM no perfil do dispositivo. Se isso não ajudar, tente não usar RAW PCM.
Lacunas entre as faixas	A reprodução sem lacunas verdadeira funciona automaticamente em dispositivos que suportam NextURI. Se você ainda ouvir lacunas, o dispositivo não o suporta ou sua implementação está com bugs — volte para saída como um fluxo contínuo (sem lacunas garantido, mas as informações da faixa e os controles de próximo/anterior param de funcionar).
EQ / DSP / ReplayGain "não faz nada"	O fluxo nativo forçado está ativado para esse dispositivo — ele os supera. Desmarque forçar fluxo nativo no perfil do dispositivo. Veja Transcodificar ou não.
Um dispositivo moderno (2020+) ignora os controles do MusicBee	A correção para dispositivos que se anunciam como MediaRenderer:2/3 está neste fork; deve funcionar. Caso contrário, capture um log de depuração e registre um problema.
O plugin carrega, mas Configurar não abre	Verifique o ErrorLog.dat do MusicBee — o plugin provavelmente travou ao carregar. Excluir o arquivo de configurações do plugin e reconfigurar geralmente resolve.
Idiomas diferentes do inglês	O plugin vem com 22 idiomas e segue o idioma do próprio MusicBee, e esta ajuda está disponível em todos eles. Para usar um diferente, defina o idioma na guia Geral.

O quão isso foi testado

Para que nada o surpreenda, aqui está honestamente o quanto o plugin tem sido usado no mundo real.

Tudo foi testado com o BubbleUPnP, com o foobar2000 como segunda referência. Todos os três papéis funcionam lá — mas o BubbleUPnP é o único homólogo contra o qual o plugin foi comprovado, então outros aplicativos de controle, outros players e dispositivos de navegação além desses dois não foram testados e se beneficiariam de testes da comunidade.

Onde isso mais importa na prática é reproduzir para um streamer físico (o papel de ponto de controle). Transições de faixa verdadeiramente sem interrupções foram confirmadas no BubbleUPnP, mas streamers reais — WiiM, Sonos, Cambridge, Eversolo, Marantz, Denon — cada um lida com a transição entre as faixas de forma ligeiramente diferente, e nenhum foi testado em hardware real. Se a reprodução sem interrupções se comportar mal em um deles, desative o NextURI para esse dispositivo para que ele volte a reproduzir uma faixa por vez.

Outras configurações

Alguns controles não pertencem a nenhuma funcionalidade específica:

Controle	O que faz
Ajuda	Abre esta página de ajuda no seu navegador web, no idioma do MusicBee (voltando para o inglês onde uma tradução ainda não está pronta).
Ler última consulta, Executar consulta, Buscar tags para os primeiros 5	Ferramentas de consulta de baixo nível na aba Depuração, destinadas ao desenvolvimento; ignore-as no uso normal.
Salvar	Salva as alterações. As configurações que são vinculadas na inicialização (porta, IP, conexões máximas, renderizador) exibem um distintivo ⚠ Reinicialização Necessária até que você reinicie o MusicBee.
Cancelar	Fecha a caixa de diálogo sem salvar.

Créditos

• Plugin original de Steven Mayall. Este fork reescreveu a navegação da biblioteca e a caixa de diálogo de configurações e adicionou o renderizador, mas o núcleo UPnP, HTTP e SSDP em que tudo se baseia ainda é em grande parte o código dele.
• O fork de código fechado UPnP 2025 de BoringName, cujo tópico de fórum público forneceu o catálogo de bugs.