Довідка

Для чого потрібен MusicBee UPnP Plugin

Плагін з відкритим вихідним кодом для MusicBee, який підключає вашу бібліотеку до пристроїв UPnP/DLNA у вашій домашній мережі — телефонів, смарт-телевізорів, hi-fi стримерів, мережевих колонок — без хмари та без входу. Це форк оригінального UPnP плагіна Стівена Мейолла, перероблений для того, щоб велику, різноманітну бібліотеку було приємно переглядати з іншого пристрою.

Дві речі відрізняють цей форк від звичайного UPnP-сервера, і вони є причиною його вибору:

• Він публікує всю MusicBee — а не лише "Музику". Ваші Фільтри, Подкасти, Аудіокниги, Радіостанції, Вхідні та ваші Списки відтворення з'являються як власні контейнери для перегляду на іншому пристрої, поряд з музикою. Більшість серверів показують плоску музичну бібліотеку і нічого іншого.
• Кожен з цих вузлів можна показувати, приховувати та формувати індивідуально. Ви вирішуєте, які вузли бачить пристрій, і надаєте кожному з них власний шлях виявлення — маршрут, яким ви заглиблюєтеся в нього (Виконавець альбому → Альбом → Треки, плоский список треків, за Жанром, за Роком…). Бібліотека з 300 000 треків у підсумку переглядається як добре організована, а не як плоский дамп даних.

Під цими двома основними ідеями плагін організований навколо одного структурного факту: MusicBee може виконувати три різні мережеві ролі, і кожен екран у діалоговому вікні налаштувань належить до однієї з них. Зрозумійте ці три ролі, і решта діалогового вікна пояснить себе сама:

• Сервер — інші пристрої переглядають бібліотеку MusicBee та витягують з неї треки. Тут знаходяться дві вищезгадані основні функції.
• Рендерер — MusicBee стає ціллю, на яку інші програми можуть відтворювати, як мережева колонка.
• Точка керування — MusicBee відтворює власний звук на віддалену колонку або стример.

Ви можете використовувати одну роль або всі три. Увімкніть лише те, що вам потрібно. У цьому посібнику кожне налаштування пояснюється поруч із функцією, до якої воно належить — немає окремого списку "налаштувань" для перехресних посилань.

Встановлення

1. Завантажте mb_UPnP_yaiol.dll зі сторінки випуску.
2. Скопіюйте його до папки плагінів MusicBee, зазвичай C:\Users\<you>\AppData\Roaming\MusicBee\Plugins\.
3. Перезапустіть MusicBee.
4. Відкрийте Редагувати → Налаштування → Плагіни, знайдіть MusicBee UPnP Plugin і натисніть Налаштувати.

DLL-файл yaiol має відмінне ім'я, тому він може знаходитися на диску та працювати разом з оригінальним плагіном без конфліктів.

Сервер — інші переглядають вашу бібліотеку

UPnP — це протокол для аудіопристроїв, щоб знаходити та керувати один одним через локальну мережу, і в ньому кожен учасник відіграє одну визначену роль. З увімкненою роллю Сервер (перемикач UPnP Server), MusicBee відіграє роль Медіасервера: він відповідає на запити виявлення у вашій локальній мережі та надає свою бібліотеку будь-якому пристрою, який запитує. З іншого пристрою ви бачите дерево медіафайлів і натискаєте, щоб відтворити; аудіо транслюється з вбудованого HTTP-сервера MusicBee безпосередньо на пристрій. MusicBee є лише джерелом — інший пристрій керує.

Чому ви б його використовували. Він перетворює один ПК, який містить всю вашу колекцію, на мережеве джерело, до якого може дістатися кожен інший гаджет, без копіювання файлів або входу в систему. Це та половина плагіна, в яку форк інвестує найбільше, і саме тут знаходяться дві головні функції — що ви публікуєте (нижче) і як формується кожен вузол.

Коли його вимкнути. Лише якщо ви ніколи не переглядаєте MusicBee з іншого пристрою. Роль незалежна від двох інших; ви можете надавати бібліотеку і при цьому залишати ролі рендерера та точки керування вимкненими.

Кілька загальних налаштувань сервера знаходяться поруч з перемикачем: ім'я сервера, яке інші пристрої показують у своєму списку, мережевий інтерфейс і порт, до яких прив'язується MusicBee (див. Пошук один одного в мережі), і обмеження максимальної кількості з'єднань на те, скільки одночасних потоків сервер буде обслуговувати одночасно.

Налаштування

Елемент керування	Що він робить
UPnP сервер: Дозволити UPnP пристроям переглядати та відтворювати з бібліотеки MusicBee	Головний перемикач для ролі Сервер — дозволяє пристроям UPnP переглядати та відтворювати з бібліотеки MusicBee.
Назва сервера	Ім'я, яке інші пристрої показують для MusicBee, коли вони його виявляють.
Макс. підключень	Максимальна кількість одночасних потоків файлів, які буде обслуговувати сервер (за замовчуванням 16, діапазон 1–256). Збільште його, якщо пристрій, що надсилає багато паралельних запитів, викликає значок ⚠ Max Conn. Набуває чинності після перезапуску.
Оновлювати статистику відтворення у MusicBee	Враховує треки, відтворені через UPnP, у кількість відтворень MusicBee та позначки часу останнього відтворення.

Опублікувати весь MusicBee, а не лише Музику

Це перша з двох головних функцій форку. Звичайний UPnP-сервер надає мережі єдину плоску бібліотеку "Музика". Цей же виводить кожну область вмісту, яку організовує MusicBee, кожну як власний контейнер верхнього рівня на пристрої перегляду.

Сім речей, які MusicBee може публікувати

Коли пристрій переглядає MusicBee, кореневий каталог, на який він потрапляє, може пропонувати всі ці елементи поруч:

• Музика — ваша основна бібліотека, сформована на ваш смак (див. шляхи виявлення нижче).
• Фільтри — вкладки фільтрів, які ви вже використовуєте у верхній частині основного вікна MusicBee (Music, ALL, FAV, фільтр Jazz, фільтр Classical, все, що ви налаштували) з'являються як точки входу, відображаючи те, як ви вже думаєте про свою бібліотеку. Фільтри зчитуються в реальному часі з тих самих файлів, які використовує сам MusicBee, тому вони залишаються синхронізованими без додаткової конфігурації.
• Подкасти — ваші підписки на подкасти, кожна з яких відкривається до своїх епізодів, із збереженням обкладинки підписки.
• Аудіокниги — категорія Audiobooks у MusicBee.
• Радіо — ваші збережені інтернет-радіостанції.
• Вхідні — папка Inbox у MusicBee з щойно доданими, ще не відсортованими треками.
• Списки відтворення — ваші списки відтворення MusicBee.

Оскільки ці елементи надходять безпосередньо з MusicBee, вони не потребують окремого налаштування — підпишіться на подкаст або додайте станцію в MusicBee, і вона буде доступна з мережі наступного разу, коли пристрій переглядатиме її. Чи дійсно з'являється кожен з них, і яку форму він приймає, — це завдання наступної функції.

За замовчуванням, Фільтри та Списки відтворення розміщуються у власній акуратній папці-обгортці. Чи дійсно відображається кожне джерело, де воно розташоване — включно з закріпленням найчастіше використовуваних високо в корені перегляду, згрупованими за їхнім типом — а також яку форму воно приймає, все це визначається для кожного вузла наступною функцією.

У попередніх версіях цієї довідки "відсутність кореневого контейнера подкастів" було зазначено як обмеження. Це вже не так — подкасти публікуються як і всі інші джерела.

Показати, приховати та сформувати кожен вузол

Це друга головна функція, і та, що дала форку його назву. Публікація семи джерел була б шумом, якби ви не могли ними керувати — тому кожен відкритий вузол незалежно перемикається, закріплюється до кореня та має власний шлях виявлення.

Ви керуєте всім цим на вкладці Вигляд діалогового вікна налаштувань, яка показує все відкрите дерево як контрольний список. Шаблон завжди однаковий: позначте вузли, з якими ви хочете працювати, потім використовуйте елементи керування поруч із деревом, щоб встановити їх усі одночасно — зробити їх видимими або прихованими, закріпити їх у верхній частині дерева або застосувати шаблон шляху. Отже, ви можете відкрити Музику, Фільтри та Списки відтворення, приховати Вхідні та Радіо, закріпити свій фільтр Джаз до кореня та надати Подкастам форму за підпискою — кожен незалежно.

Показати, приховати та закріпити кожен вузол

Два перемикачі визначають, чи і де з'являється вузол, незалежно від його форми. Обидва знаходяться на вкладці Вигляд як тристанні прапорці, що діють на кожен вузол, який ви позначили в дереві:

• Видимий — чи пристрої взагалі бачать вузол. Зніміть прапорець, щоб приховати вузол; він залишається у вашій бібліотеці, він просто перестає рекламуватися. (Оскільки він діє на позначений набір, прапорець показує затінений "змішаний" стан, коли ваш вибір частково видимий, частково прихований.) Приховані вузли відображаються сірим кольором у дереві — а папка стає сірою, коли кожен вузол у ній приховано — тож один погляд підкаже вам, що ще відкрито.
• Верхній рівень — чи вузол також закріплений високо в корені перегляду. Закріплення є додатковим: вузол все ще з'являється у своїй звичайній папці-оболонці і отримує копію біля верхньої частини кореня, згруповану за власним типом — закріплений фільтр знаходиться безпосередньо під папкою Фільтри, закріплений список відтворення безпосередньо під папкою Списки відтворення — тож ваші ярлики залишаються поруч із тим, до чого вони належать. Закріплені вузли позначаються ★ у діалоговому вікні, щоб ви могли з першого погляду побачити, які з них підняті.

Коли фільтр або список відтворення закріплено в корені, його може бути важко відрізнити від звичайного джерела верхнього рівня, тому ви можете додати короткий префікс до його відображуваного імені (встановлюється на вкладці Параметри бібліотеки). Префікс є буквальним — все, що ви введете, буде розміщено перед іменем дослівно, тому додайте свій власний пробіл, якщо він вам потрібен.

Приклад роботи. Ви переважно переміщуєтеся за допомогою фільтра Jazz та списку відтворення Friday Night, обидва наразі знаходяться всередині папок-обгорток Filters та Playlists.

Ви відмічаєте обидва вузли в дереві перегляду та натискаєте Верхній рівень. Кожен тепер показує ★ у діалоговому вікні. На пристрої для перегляду вони все ще відображаються всередині своїх папок-обгорток, як і раніше, але також отримують копію високо в корені, кожна поруч зі своїм типом: закріплений фільтр Jazz знаходиться безпосередньо під папкою Filters, а закріплений список відтворення Friday Night — безпосередньо під папкою Playlists. Якщо префікс фільтра встановлено на Filter: , а префікс списку відтворення — на Playlist: , дві закріплені копії відображаються як Filter: Jazz та Playlist: Friday Night — відрізняються від їхніх копій у папках-обгортках, і кожна знаходиться поруч із папкою свого типу. Зніміть позначку Верхній рівень для будь-якого з них, і його закріплена копія зникне, залишивши копію в папці-обгортці недоторканою.

Це замінює старі глобальні перемикачі «відображати фільтри в корені» / «відображати списки відтворення в корені»: закріплення тепер є вибором, який ви робите для кожного вузла, для будь-якого джерела, а не перемикачем «все або нічого» для фільтрів та списків відтворення.

Налаштування

Елемент керування	Що він робить
Видимий	Показує або приховує кожен позначений вузол. Приховані вузли залишаються у вашій бібліотеці, але не рекламуються пристроям. Затінений «змішаний» стан, коли виділення частково видиме.
Верхній рівень	Також закріплює кожен позначений вузол високо в корені перегляду, згрупований за його типом — закріплення фільтрів під папкою «Фільтри», закріплення списків відтворення під папкою «Списки відтворення» (адитивно — вузол також зберігає своє звичайне місце). Закріплені вузли позначаються ★ у діалоговому вікні.
Префікс фільтра (коли у корені)	Літеральний текстовий префікс, що розміщується перед назвою фільтра, коли він закріплений у корені (допомагає згрупувати закріплені копії).
Префікс списку відтворення (коли у корені)	Літеральний текстовий префікс, що розміщується перед назвою списку відтворення, коли він закріплений у корені.

Шляхи виявлення — маршрут деталізації кожного вузла

Шлях виявлення — це маршрут, яким браузер проходить всередині вузла. Той самий вузол може бути представлений як Виконавець альбому → Альбом → Треки, або як єдиний плоский список треків, або згрупований за Жанром, а потім за Виконавцем, або за Роком. Шлях будується з одного або кількох рівнів (поле, за яким групується кожен рівень), що закінчується листком (що показує найглибший рівень — альбоми, потім їхні треки, або плоский список треків). Вузол може навіть містити кілька шляхів одночасно, тому він пропонує більше одного способу входу.

Різний вміст вимагає різних форм, і неправильна форма робить вузол непридатним. Музика вимагає групування за виконавцем альбому; список відтворення вимагає плоского впорядкованого списку; подкасти вимагають своїх підписок. Кожен вузол отримує правильну відповідь, тому що кожен містить свій власний шлях.

Приклад. У вас є фільтр Jazz на 5000 треків і список відтворення "Friday Night" на 30 треків, обидва доступні.

• Для фільтра Jazz ви застосовуєте шаблон, шлях якого — Виконавець альбому → Альбом → Треки. На пристрої ви деталізуєте: виконавців, потім альбоми цього виконавця, потім треки альбому в порядку диск-трек.
• Для списку відтворення ви застосовуєте шаблон Плоскі треки. Відкривши його, ви отримаєте 30 треків у порядку списку відтворення, без шару виконавця чи альбому між ними — саме те, чим має бути список відтворення.

Той самий плагін, те саме діалогове вікно, два вузли, дві абсолютно різні форми — тому що шлях є властивістю вузла, а не глобальним налаштуванням. Ви не можете передбачити макет вузла на пристрої, не знаючи, який шаблон він несе; ось чому це потрібно пояснити.

Вузол не просто отримує копію шаблону — він слідує йому. Дерево перегляду показує, якому шаблону слідує кожен вузол, одразу після назви вузла, і редагування шаблону на вкладці Шляхи негайно змінює форму кожного вузла, що слідує йому — без повторного застосування вузол за вузлом. Застосування шаблону до прихованого вузла також робить його знову видимим: застосування — це жест "покажи мені це, сформоване так", тоді як приховування залишається з прапорцем "Видимий". Кожен рядок шаблону показує живий лічильник (n) вузлів, що слідують йому, і шаблон можна видалити лише тоді, коли цей лічильник дорівнює нулю — кнопка видалення залишається вимкненою, доки щось слідує шаблону, тому вузол ніколи не може бути осиротілим після видалення. Щоб побачити, які саме вузли слідують шаблону, кнопка-фільтр поруч із деревом перегляду фільтрує дерево до лише цих вузлів; вибір іншого шаблону повторно фільтрує, а вимкнення фільтра відновлює повне дерево. Видалення невикористаного шаблону також тепер працює — стандартні значення, що постачаються, більше не створюються тихо знову під час наступного завантаження плагіна.

Коли шлях закінчується листком Альбом → Треки, ви також вирішуєте, що вважається одним альбомом. Замість групування суворо за назвою альбому, ви вибираєте одне або кілька полів — Альбом, Сортувати альбом, Рік, Виконавець альбому — які разом вирішують, які треки об'єднуються в один альбом, як читається його заголовок, і порядок появи альбомів, кожне поле можна сортувати за зростанням або спаданням. Додавання Виконавця альбому розділяє два однойменні альбоми різних виконавців; додавання Року за спаданням перераховує альбоми виконавця від найновіших до найстаріших. Коли ви групуєте за роком, MusicBee пропонує два поля, які відображають його власні — Рік, повний тег дати (який може містити повну дату, наприклад 2024-03-15), і Рік (рррр), лише чотиризначний рік — тому вибір Рік (рррр) збирає всі випуски року разом, замість того, щоб розділяти їх за точною датою.

Стандартні значення є розумними — нові фільтри формуються за виконавцем альбому, списки відтворення та Вхідні отримують розумні стандартні значення — тому для типового випадку ви нічого не змінюєте. Зверніться до вкладки Перегляд, коли ви хочете, щоб певний вузол мав іншу форму.

Налаштування

Ви створюєте іменовані, багаторазові шаблони шляхів на вкладці Шляхи, а потім застосовуєте їх до вузлів на вкладці Перегляд.

Елемент керування	Що він робить
Застосувати до вибраних кінцевих точок	Робить так, щоб кожен вузол, який ви позначили в дереві, слідував поточному вибраному шаблону (і знову відображає його, якщо він був прихований).
Розгорнути все / Згорнути все	Розгортає або згортає все дерево кінцевих точок.
Показувати лише вузли, що відповідають вибраному шаблону	Перемикач фільтра: фільтрує дерево кінцевих точок до лише тих вузлів, що слідують вибраному шаблону. Виберіть інший шаблон для повторного фільтрування; вимкніть, щоб відновити повне дерево.
Шаблон	Іменований шаблон шляху, що редагується.
↑ / ↓	Переміщує вибраний шаблон вгору або вниз у списку, щоб упорядкувати представлення ваших шаблонів.
Групувати за	Поле(я), за яким групується рівень (наприклад, Виконавець альбому).
Лист	Що показує найглибший рівень.
Альбом → Треки (AT)	Режим листка: Альбом → Треки — деталізація через альбоми до їхніх треків.
Прості треки (T)	Режим листка: Плоскі треки — єдиний плоский список треків.
Включити [Усі треки] на кожному рівні	Додає ярлик [Усі треки] на кожному рівні. Відображається лише в режимі Альбом → Треки.
Групувати альбоми за	Визначає, що вважається одним альбомом, як читається його назва, і порядок появи альбомів — виберіть одне або кілька полів (Альбом, Сортувати альбом, Рік, Виконавець альбому…), кожне зі своїм перемикачем за зростанням/спаданням. Відображається лише в режимі Альбом → Треки.
Додати / Видалити	Додати або видалити шлях у шаблоні.

Шляхи прив'язані до типу вузла, якому вони відповідають

Не кожне поле має значення для кожного типу вузла. Радіостанція не має альбому чи року; епізод подкасту має підписку, папку та дату публікації, але не має виконавця альбому. Отже, кожен шлях належить до однієї з трьох категорій — Стандартний (ваша музика, фільтри, аудіокниги, вхідні та списки відтворення, які містять повні теги), Радіо або Подкаст — і ця категорія одночасно визначає дві речі: за якими полями ви можете групувати, і до яких вузлів можна застосувати шлях.

На вкладці Шляхи список шаблонів відображається у двох розділах: Стандартний — де знаходяться ваші власні шаблони, і де створюється кожен новий шаблон — і Зарезервований розділ, що містить шаблони Радіо та Подкастів. Під час редагування Стандартного шаблону меню полів пропонує все; шаблон Радіо пропонує лише поля, які фактично має станція; шаблон Подкасту лише те, що має епізод — його папку, його підписку та рік публікації. На вкладці Вигляд застосування шаблону підсвічує лише ті вузли, яким він відповідає — решта стають сірими і їх не можна позначити — тому Стандартний шлях ніколи не може потрапити на вузли Радіо або Подкастів.

Насправді ви взагалі ніколи нічого не застосовуєте до Радіо або Подкастів: кожен з них постійно пов'язаний з шаблоном своєї категорії. Змініть шаблон Радіо або Подкастів на вкладці Шляхи, і вузол зміниться сам по собі; якщо вибрано Зарезервований шаблон, кнопка Застосувати просто вимкнена, тому що немає чого застосовувати. Це запобігає створенню шляху, який тихо нічого не створює, групуючи за полем, яке вузол не може заповнити — і оскільки шаблон, за яким слідують, ніколи не може бути видалений (див. Шляхи виявлення вище), шаблони Радіо та Подкастів завжди доступні для зміни.

Виконавці, згруповані за назвою для сортування

У будь-якому музичному вузлі виконавці групуються та впорядковуються за алфавітом за тегом Sort Album Artist, а не за відображуваною назвою. Це та частина, яка дивує людей, тому ось що саме відбувається.

Практичний приклад. Припустимо, трек має такі теги:

• Виконавець = Bob Dylan
• Sort Album Artist = Dylan, Bob

У дереві перегляду Ділан згрупований під літерою D (від Dylan, Bob), а не під B (від Bob Dylan). Тег сортування визначає як групування, так і алфавітну позицію, саме так, як це зробив би hi-fi браузер або музичний магазин.

Це автоматично і повністю визначається вашими існуючими тегами MusicBee — нічого налаштовувати не потрібно.

Багатозначні теги розгалужуються

Коли трек має Виконавець альбому (або Жанр), що містить більше одного значення, трек з'являється під кожним значенням окремо, замість створення одного об'єднаного запису.

Приклад. Якщо Виконавець альбому треку містить два значення: yaiol; Ars Ricercata. Цей трек з'являється під обома yaiol і Ars Ricercata — по одному разу в гілці кожного виконавця — а не під одним фальшивим виконавцем "yaiol; Ars Ricercata". Багатозначні теги виконавців розгалужуються так само, як і багатозначні теги жанрів.

Як і групування за назвою для сортування, це відбувається автоматично та керується тегами.

Групування довгих списків за першою літерою

Якщо рівень стає занадто довгим, щоб зручно прокручувати на телефоні, його можна групувати за першою літерою — вставити шар A, B, C, … над записами, щоб ви спочатку вибрали літеру. Це налаштовується для кожного поля всередині шаблону, з контекстного меню поля: Розділити [поле] за першою літерою. Залиште це вимкненим для коротких списків; увімкніть це для рівнів — зазвичай художників — де список величезний.

Перегляд тегу як вкладеного дерева

Деякі теги містять ієрархію в одному значенні з роздільником — тег Групування Jazz/Cool Jazz, користувацький жанр Electronic/Ambient/Drone. За замовчуванням весь цей рядок є одним плоским записом, тому структура, яку ви закодували в тезі, втрачається. Позначте поле як ієрархічне, і плагін розділить кожне значення за вибраним вами роздільником і перетворить його на дерево для деталізації — ви вибираєте Jazz, потім Cool Jazz, точно так, як написано в тезі.

Ви налаштовуєте це на вкладці Параметри бібліотеки: виберіть поле, введіть один символ, який розділяє його рівні (наприклад, /), і додайте його до списку. Потім це застосовується скрізь, де це поле використовується як рівень групування в будь-якому шляху виявлення. Треки, позначені на гілці, а не на листі — позначені просто Jazz, без піджанру — з'являються під записом [Jazz] у дужках поруч із глибшими гілками, тому нічого не приховано. Гілка, яка містить лише одну дочірню гілку, згортається автоматично (те саме правило одного вибору, як і скрізь), і ; не можна використовувати як роздільник — це власний роздільник багатозначних значень MusicBee, тому значення, як-от Rock; Jazz/Cool Jazz, спочатку розділяється на два теги, а потім кожен деталізується.

Приклад. Ваші треки мають тег Групування, як-от Jazz/Cool Jazz, Jazz/Hard Bop та Classical/Baroque, і шлях виявлення, який групує за Групуванням. У плоскому вигляді вузол містить три довгі записи. Позначте Групування ієрархічним за допомогою /, і той самий вузол тепер відкривається на Jazz та Classical; відкриття Jazz розкриває Cool Jazz та Hard Bop. Трек, позначений просто Jazz, відображається під записом [Jazz] поруч із ними. Ви не можете передбачити це розташування лише за тегом — воно повністю залежить від того, яке поле ви позначили і з яким роздільником — тому варто налаштувати його свідомо.

Налаштування

Елемент керування	Що він робить
Ієрархічні поля	Список полів, що відображаються як дерево для деталізації, кожне з яких поєднано зі своїм односимвольним роздільником. Виберіть поле, введіть роздільник (не ;) і додайте його; потім поле деталізується рівень за рівнем скрізь, де шлях виявлення групує за ним.

Рівні з одним вибором згортаються самі по собі

Коли рівень групування має лише один запис для того, що ви переглядаєте, плагін пропускає його замість того, щоб змушувати вас відкривати папку, яка містить одну папку — ви одразу переходите до наступного реального вибору. Нічого налаштовувати не потрібно; це відбувається автоматично, на кожному шляху.

Приклад роботи. Ваш шлях групується за Типом запису → Альбом → Треки. Виконавець, який випускав лише LP, інакше змусив би вас відкривати єдину папку Тип запису → LP лише для того, щоб дістатися до альбомів. Натомість, відкриття цього виконавця одразу переносить вас до альбомів — надлишковий рівень зникає для цього виконавця, тоді як виконавець з LP та EP все ще показує вибір Типу запису. Кілька рівнів з одним записом поспіль згортаються разом, і рівень за першою літерою, що має лише одну літеру, зникає так само.

Мініатюри альбомів у дереві перегляду

Альбоми передають свою обкладинку у відповідь на запит перегляду, тому пристрої, які показують мініатюри у своїх списках, фактично відображають їх. (Оригінальний плагін прикріплював обкладинку лише до окремих треків, тому списки альбомів відображалися як звичайний текст.) Нічого налаштовувати — вона просто передається разом з альбомом.

Пошук і перемішування з пристрою

Більшість програм керування розміщують поле пошуку та папку "випадковий" або "перемішати" поруч із деревом перегляду. Обидва звертаються до MusicBee як до одного типу запиту UPnP, і обидва відповідають у реальному часі з вашої бібліотеки, а не з попередньо створеного індексу — тому трек, який ви перемітили хвилину тому, одразу знайдеться.

Пошук відповідає за назвою або за виконавцем. Пошук за назвою розглядає назву треку, коли ваша програма шукає треки, і назву альбому, коли вона шукає альбоми. Пошук за виконавцем відповідає або виконавцю треку, або виконавцю альбому, тому компіляція з'являється незалежно від того, чи вводите ви ім'я виконавця, чи назву, під якою альбом зберігається. Результати повертаються по одній сторінці під час прокручування, тому термін, який відповідає тисячам треків, залишається чутливим замість того, щоб зависати або повертатися до перших результатів.

Приклад роботи. Ви шукаєте Blue з подання альбому вашої програми керування. Ви отримуєте альбоми з назвою Blue — Kind of Blue, Blue Train — а не кожен альбом, який випадково містить трек під назвою "Blue". Переключіть програму на подання треків і шукайте те саме слово, і ви отримаєте треки замість цього. Яке поле відповідає, залежить від того, що запитала ваша програма, а не від того, що ви ввели.

Папки перемішування — записи Випадкові треки та Випадкові альбоми, які показують деякі програми — це запит на фрагмент усього, без доданого терміна пошуку. За замовчуванням це "все" — це вся ваша музична бібліотека, що рідко є тим, що вам потрібно, якщо половина її — це розмовне слово або матеріал, який ви ніколи не перемішуєте. Випадкове відтворення з, на вкладці Параметри бібліотеки, дозволяє вам вказати на один із ваших фільтрів MusicBee замість цього, тому кожен випадковий запит береться лише з вмісту цього фільтра. Приховані фільтри також пропонуються тут — визначення області перемішування не має нічого спільного з тим, чи хочете ви, щоб цей фільтр з'являвся в дереві перегляду. Відкриття папки перемішування всередині фільтра на пристрої все одно перемішує цей фільтр: явний вибір, зроблений під час перегляду, завжди переважає над налаштуванням.

Налаштування

Елемент керування	Що він робить
Випадкове відтворення з	Звідки береться запит на перемішування пристрою — Вся музика (вся ваша бібліотека, за замовчуванням) або іменований фільтр MusicBee. Якщо вибраний фільтр пізніше видаляється або перейменовується в MusicBee, налаштування тихо повертається до всієї бібліотеки.

Адаптувати потік для кожного пристрою

Перегляд – це лише половина справи; аудіо все ще має відтворюватися на апаратному забезпеченні, яке сильно відрізняється за тим, що воно приймає. Ця функція дозволяє MusicBee налаштовувати кожен потік — і вона є спільною: вона застосовується як тоді, коли роль Сервера подає трек на пристрій перегляду, так і тоді, коли роль Точки керування відтворює його на віддаленому рендерері. Її керують дві концепції: профілі пристроїв (що може обробляти пристрій) та ланцюжок пріоритетів транскодування (чи буде трек перекодовано взагалі).

Профілі пристроїв — адаптація до кожного пристрою

Реальне обладнання UPnP непослідовне щодо того, що воно приймає: один стрімер хоче 24-бітний FLAC, інший відтворює лише 16-бітний PCM, третій бреше про те, які кодеки він підтримує. Профіль пристрою — це спосіб навчити плагін обмеженням і особливостям одного пристрою.

Як вибирається профіль. Кожен пристрій ідентифікує себе рядком User-Agent при підключенні. Профіль говорить: "застосуй мене, коли user-agent містить цей фрагмент". Коли пристрій підключається, плагін знаходить відповідний профіль; якщо жоден не відповідає, використовується вбудований профіль Generic Device. Ви можете перерахувати кілька фрагментів, розділених | (наприклад, Linn|ChorusDS|BubbleDS), щоб один профіль охоплював сімейство пов'язаних пристроїв.

Що контролює профіль. Обмеження, які пристрій не може перевищувати — максимальний розмір зображення для обкладинки альбому, дозволений діапазон частот дискретизації, максимальна бітова глибина, пониження до стерео — плюс, коли трек потребує конвертації, який вихідний формат і частоту дискретизації використовувати для конвертації. Окрема група перемикачів "проблемного пристрою" обходить специфічні апаратні помилки (обробка raw-PCM, порядок байтів, заголовок HTTP content-length). Вони існують, тому що відповідність UPnP у реальному світі є нерівномірною; більшість людей ніколи їх не чіпають.

Коли торкатися профілю. Тільки коли конкретний пристрій працює неправильно. За замовчуванням загальний профіль, плюс стандартні налаштування для кожного пристрою, що постачаються для поширеного обладнання, охоплюють більшість випадків. Щоб знайти user-agent пристрою, щоб ви могли його націлити, увімкніть налагоджувальне логування (див. Діагностика), відтворіть щось з пристрою та прочитайте рядок useragent= у журналі.

Найважливіший перемикач профілю — force native stream — взагалі не стосується обмежень; він вирішує, чи застосовується будь-що з вищезазначеного. Це наступна концепція.

Налаштування

Елемент керування	Що він робить
Назва	Відображуване ім'я профілю.
Застосовується, коли user-agent містить	Фрагмент(и) user-agent, які пристрій повинен містити, щоб відповідати цьому профілю; розділяйте альтернативи |. Пристрої, що не відповідають, повертаються до загального профілю.
Максимальний розмір зображення	Максимальний розмір зображення обкладинки альбому в пікселях, що надсилається на цей пристрій (160 пікселів — стандарт DLNA; більші розміри не підтримуються повсюдно).
Частота дискретизації на виході / до	Діапазон частот дискретизації, які приймає пристрій; джерела поза ним конвертуються (примушує до перекодування).
Канали / лише стерео	Змішує багатоканальний звук до стерео для пристроїв, які підтримують лише два канали.
Максимальна бітова глибина	Найвища бітова глибина, яку приймає пристрій; джерела з більшою глибиною конвертуються.
Вихідний формат	Коли потрібне перекодування, формат для конвертації (PCM, FLAC, MP3, AAC, Ogg).
Частота дискретизації на виході	Частота дискретизації, яку використовувати при перекодуванні; "така ж, як джерело" зберігає оригінал.
Не використовувати RAW PCM	Обгортає PCM у контейнер WAV замість надсилання raw L16/L24. Для пристроїв, які спотворюють raw PCM (деякі Marantz).
Примусово використовувати little endian для PCM потоків	Надсилає PCM у little-endian замість big-endian, як зазначено в специфікації. Виправляє відтворення білого шуму на пристроях, які очікують little-endian.
Довжина вмісту	Як заповнити заголовок HTTP Content-Length: Default (правильне значення), None (опустити), PCM Only, або Fixed (сторожове "величезне" значення). Для пристроїв, які неправильно обробляють заголовок.

Транскодувати чи ні — ланцюжок пріоритетів

"Транскодування" означає перекодування треку на льоту — у формат, який пристрій може відтворити, або щоб можна було застосувати еквалайзер MusicBee та вирівнювання гучності. Плагін радше не транскодуватиме (надсилання оригінального файлу швидше та без втрат), тому він дотримується фіксованого ланцюжка правил для прийняття рішення. Вищі правила перемагають і мовчки скасовують нижчі. Це єдина найбільш неправильно зрозуміла частина плагіна, оскільки кілька налаштувань виглядають так, ніби вони повинні співпрацювати, але цього не відбувається.

Пріоритет	Правило	Ефект
1 (найвищий)	Примусове транскодування (для кожного профілю пристрою)	Завжди транскодувати. Перевизначає все нижче. Взаємовиключне з примусовим нативним — встановлення одного знімає позначку з іншого.
2	Примусовий нативний потік (для кожного профілю пристрою, за замовчуванням УВІМКНЕНО)	Ніколи не транскодувати для цього пристрою. Повністю пригнічує правила 3–5 — надсилає оригінальні байти незалежно від формату, ефектів чи обмежень.
3	Еквалайзер/DSP та ReplayGain (Бібліотека)	Примусове транскодування, щоб можна було обробити аудіо. Мовчки ігнорується, якщо перемагає правило 2.
4	Частота дискретизації / бітова глибина / лише стерео (профіль пристрою)	Джерело поза діапазоном → транскодувати для відповідності. Мовчки ігнорується, якщо перемагає правило 2.
5 (найнижчий)	Підтримка кодеків (профіль пристрою)	Вихідний кодек, який пристрій не може відтворити → транскодувати у вихідний формат профілю. Мовчки ігнорується, якщо перемагає правило 2.

Оскільки примусовий нативний потік за замовчуванням УВІМКНЕНО для кожного профілю, поведінка "з коробки" така: передати пристрою оригінальний файл і більше нічого не робити. Це абсолютно правильно для сучасного пристрою в хорошій мережі — але це означає, що ефекти Бібліотеки та аудіообмеження профілю, здається, "нічого не роблять", доки ви не зміните правило 2.

Приклад роботи. Ви хочете, щоб вирівнювання гучності ReplayGain від MusicBee застосовувалося до вашого стрімера. Ви встановлюєте позначку Вирівнювати гучність відтворення за допомогою режиму Replay Gain, активного в MusicBee у розділі Бібліотека. Ви відтворюєте трек — і гучність зовсім не вирівнюється.

Чому: у профілі стрімера все ще увімкнено примусовий нативний потік (правило 2). Правило 2 має вищий пріоритет, ніж правило ReplayGain (правило 3), тому плагін надсилає незмінений файл, а ваше налаштування ReplayGain мовчки пропускається.

Виправлення: відкрийте профіль цього пристрою та зніміть позначку з примусового нативного потоку. Оскільки примусовий нативний потік є для кожного профілю, ви можете залишити його увімкненим для вашого біт-ідеального Hi-Fi ЦАП і вимкнути для портативного динаміка, якому потрібен ReplayGain — кожен пристрій отримує правильну відповідь.

Загальні правила:

• Хочете, щоб еквалайзер/DSP або ReplayGain застосовувалися до пристрою? Вимкніть примусовий нативний потік у профілі цього пристрою.
• Хочете гарантувати свіже транскодування (для тестування або для пристрою, який задихається від нативних файлів)? Увімкніть примусове транскодування у його профілі — воно має вищий пріоритет за все.
• В іншому випадку залиште примусовий нативний потік увімкненим. Це налаштування з найвищим впливом у плагіні, і за замовчуванням воно підходить для більшості сучасного обладнання.

Налаштування

Елемент керування	Що він робить
Примусово використовувати нативний потік (обійти транскодер)	Надсилає оригінальні байти файлу, обходячи транскодер, ефекти, ReplayGain та аудіообмеження профілю. За замовчуванням УВІМКНЕНО. Налаштування відтворення з найвищим впливом; правило 2 ланцюжка вище.
Примусове транскодування (взаємовиключно з примусовим нативним потоком)	Примусово пропускає кожен потік до цього пристрою через транскодер. Має вищий пріоритет, ніж примусовий нативний; ці два взаємовиключні (встановлення одного знімає позначку з іншого). Правило 1.
Використовувати еквалайзер та DSP ефекти, активні в MusicBee [вимагає транскодування]	Застосовує еквалайзер MusicBee та ефекти DSP до вихідного аудіо. Примушує транскодування (правило 3) і пригнічується на будь-якому пристрої, профіль якого має увімкнений примусовий нативний потік.
Вирівнювати гучність відтворення, використовуючи режим ReplayGain, активний в MusicBee [вимагає транскодування]	Застосовує вирівнювання гучності ReplayGain від MusicBee. Примушує транскодування (правило 3) і пригнічується на будь-якому пристрої, профіль якого має увімкнений примусовий нативний потік.
Примусово використовувати нативний потік для радіо (обійти транскодер для станцій)	Надсилає радіо/потокові джерела незміненими, обходячи транскодер спеціально для станцій.

Рендерер — MusicBee як ціль для відтворення

З увімкненою роллю Рендерер (перемикач UPnP Renderer), MusicBee повідомляє мережі: "Я пристрій, на який можна відтворювати". Окрема програма-контролер — пульт на телефоні, інший медіа-контролер — може тоді вибрати MusicBee і передати аудіо для відтворення на цьому ПК. Ви даєте цілі дружнє ім'я рендерера, щоб його можна було розпізнати у списку іншої програми.

Що він може відтворювати. Обидва типи доріжок, які може надсилати керуюча програма. Якщо доріжка походить з власної бібліотеки MusicBee — ви переглядали бібліотеку цього ПК на своєму телефоні та натиснули пісню — MusicBee відтворює файл безпосередньо зі свого диска, без змін, без втрати якості, яку могло б спричинити кругове пересилання через мережу. Якщо доріжка знаходиться деінде — файл, що зберігається на самому телефоні, NAS, іншому медіа-сервері — MusicBee отримує його та відтворює тут.

Доріжка, надіслана з іншого місця, спочатку копіюється, і чому це важливо. Для доріжки, якої немає у вашій бібліотеці, MusicBee тихо завантажує копію до тимчасової папки та відтворює її, замість того, щоб слухати її через мережу під час відтворення. Це необхідно: все, що MusicBee розглядає як живий мережевий потік, можна запускати та зупиняти, але не переміщувати, тому перехід до іншої точки пісні був би неможливим, а доріжка відображалася б як проста веб-адреса замість її назви. Відтворення реального файлу на власному диску дозволяє уникнути обох проблем. Копіювання займає близько секунди в домашній мережі. Кілька копій зберігаються поруч — та, що відтворюється, та, що стоїть наступною в черзі, і одна позаду, щоб пропуск назад був миттєвим — а старіші видаляються, коли надходять нові доріжки; все, що залишилося, очищається наступного разу, коли MusicBee запускається. Довжина доріжки не є перешкодою: довгий файл високої роздільної здатності або DSD завантажується як будь-який інший.

Інтернет-радіо розпізнається і залишається без змін. Пряма трансляція ніколи не копіюється, оскільки її неможливо завантажити до кінця, і все одно немає чого перескакувати — MusicBee просто відтворює її як потік. Керуюча програма повідомляє, який з двох типів вона надсилає, тому це не вимагає налаштувань або здогадок з вашого боку. Те саме стосується, якщо копію не вдається отримати з будь-якої іншої причини: відтворення продовжується через мережу, і лише тоді назва та повзунок позиції стають ненадійними.

Альбоми відтворюються без пауз. Коли керуюча програма повідомляє MusicBee, що буде далі — більшість так робить — ця доріжка завантажується, поки поточна ще відтворюється, і власний плеєр MusicBee перетинає межу. Таким чином, живий запис, DJ-сет або безперервний класичний твір, надісланий з телефону, відтворюється так, як має бути, а не зупиняється на кожній доріжці.

Навіщо це використовувати. Це дозволяє телефону або планшету використовувати цей ПК як UPnP-динамік — зручно, коли ПК підключений до хороших динаміків, і ви хочете керувати ним з дивана, незалежно від того, чи знаходиться музика на ПК, чи на телефоні у вашій руці.

Коли його вимикати. Залишайте його вимкненим, якщо ви спеціально не хочете надсилати аудіо на цей ПК з іншої програми. Якщо він вимкнений, MusicBee не з'явиться як ціль ніде, що зазвичай є тим, що вам потрібно.

Використовуйте одну керуючу програму одночасно. UPnP не має поняття про те, що програма "володіє" рендерером: будь-яка програма в мережі може надсилати доріжки до MusicBee, і будь-яка програма, що спостерігає, може реагувати на те, що вона бачить. Отже, якщо два плеєри одночасно спрямовані на MusicBee, ви отримаєте поведінку, яка виглядає як помилка, але не є нею. Друга програма, яка все ще має вибраний MusicBee, продовжує спостерігати, бачить, як доріжка, яку вона надіслала, зупиняється, робить висновок, що її пісня закінчилася, і послужливо надсилає наступну зі своєї черги — тому музика раптово перескакує на інший альбом, або натискання далі в одній програмі запускає пісню в іншій. Зупинка відтворення в другій програмі не є достатньою, тому що вона залишається вибраною і продовжує спостерігати. Спрямуйте її назад на власний динамік телефону, на інший пристрій або закрийте її належним чином.

Примітка щодо зрілості. Рендерер новіший за роль сервера і пройшов менше тестування на реальному обладнанні. Якщо певна програма-контролер керує ним дивно, про це корисно повідомити.

Налаштування

Елемент керування	Що він робить
UPnP рендерер : Дозволити іншим програмам відтворювати на MusicBee	Головний перемикач для ролі Рендерер — дозволяє іншим програмам відтворювати на MusicBee. Набуває чинності після перезапуску MusicBee.
Назва рендерера	Ім'я, яке цей ПК рекламує як рендерер, відображається у списках пристроїв інших програм.

Control point — відтворення на віддалений динамік

З увімкненою роллю Control point (перемикач UPnP Control Point) мережеві рендерери UPnP/DLNA з'являються як пристрої виведення в MusicBee — там само, де ви обираєте свою звукову карту. Виберіть один, натисніть Відтворити, і MusicBee передаватиме аудіо на цей віддалений динамік або стример, поки ви продовжуєте використовувати власний інтерфейс MusicBee як пульт дистанційного керування.

Навіщо це використовувати. Це дозволяє hi-fi стримеру або мережевому динаміку поводитися як ще один вихід MusicBee, без додаткового програмного забезпечення між ними.

Коли це вимкнути. Залиште його вимкненим, якщо ви завжди відтворюєте звук лише через власні динаміки цього ПК.

Дві речі визначають поведінку цієї ролі. Перша — це безперервне відтворення (нижче). Друга — Адаптувати потік до кожного пристрою — ті самі профілі пристроїв та пріоритет транскодування, що керують сервером, застосовуються і тут, оскільки плагін знову подає аудіо на віддалений пристрій. Control point також повторно використовує HTTP-сервер MusicBee для виведення аудіо, тому порт сервера та правила брандмауера мають значення тут, навіть якщо ви ніколи не вмикаєте роль Сервера.

Налаштування

Елемент керування	Що він робить
UPnP точка керування : Додати мережеві UPnP/DLNA рендерери як пристрої виведення MusicBee	Головний перемикач для ролі Control point — додає мережеві рендерери UPnP/DLNA як пристрої виведення MusicBee.

Безперервне відтворення — два різні механізми

Деяка музика має відтворюватися без перерви — живі альбоми, класичні твори, діджейські сети, концептуальні записи. Півсекунди тиші між треками псує їх. Плагін пропонує два способи усунення цієї паузи, і вони працюють дуже по-різному.

Справжнє безперервне відтворення (NextURI). Коли рендерер заявляє про підтримку, плагін попередньо завантажує наступний трек на пристрій до закінчення поточного, тому пристрій перетинає межу внутрішньо без тиші — як CD-плеєр. Це кращий механізм: кожен трек зберігає власні метадані, пошук і пропуск все ще працюють, і нічого не потрібно вмикати — плагін використовує його автоматично на сумісних пристроях. Для кожного пристрою ви можете вимкнути його (для обладнання, чия реалізація є помилковою) або наказати плагіну не очищати трек у черзі, коли список порожній (обхідний шлях для пристроїв, які розглядають порожню чергу як "зупинку").

Безперервний потік. Старіший резервний варіант об'єднує все в один нескінченний потік. Він гарантує відсутність пауз на будь-якому пристрої — але за реальну ціну: рендерер показує інформацію про перший трек протягом усієї сесії, елементи керування "наступний/попередній" перестають працювати, і оскільки все злито в один потік, все має бути перекодовано (force-native не може застосовуватися). Екранна мітка пояснює компроміс.

Що використовувати. Віддавайте перевагу справжньому безперервному відтворенню — воно автоматичне та без втрат. Переходьте до безперервного потоку лише для пристрою, який не підтримує NextURI, і де паузи вас справді турбують, приймаючи те, що ви втрачаєте метадані для кожного треку та елементи керування транспортом. Ці два варіанти взаємовиключні: увімкнення безперервного потоку вимикає NextURI, тому ви не можете випадково запустити обидва.

Налаштування

Елемент керування	Що він робить
Увімкнути безперервне відтворення (NextURI) для цього пристрою	Вмикає справжнє безперервне відтворення (NextURI) для цього пристрою. Увімкнено для сумісних пристроїв; вимкніть, якщо реалізація пристрою є помилковою.
Не надсилати порожній NextURI, коли черга порожня	Зупиняє плагін від надсилання порожнього NextURI, коли черга порожніє — обхідний шлях для пристроїв (наприклад, Denon), які розглядають це як "зупинку".
Виводити як безперервний потік	Надсилає один безперервний об'єднаний потік замість окремих треків. Усуває паузи на будь-якому пристрої, але рендерер показує лише інформацію про перший трек, елементи керування транспортом перестають працювати, і все перекодовується. Вимикає NextURI, поки увімкнено.

Знаходження один одного в мережі

Перш ніж будь-яка з ролей зможе працювати, пристрої повинні знайти один одного. Сервер MusicBee прив'язується до мережевої адреси та TCP порту, потім оголошує себе в локальній мережі через SSDP, щоб пристрої могли його виявити. Порт за замовчуванням – 9779; якщо цей порт вже зайнятий, плагін автоматично вибирає вільний поруч, і пристрої все одно його виявляють (вам потрібно встановити фіксований порт лише в тому випадку, якщо ваша конфігурація цього вимагає).

Два параметри мають значення на машинах з незвичайними мережевими налаштуваннями:

• IP address / network interface. "Automatic" обслуговує всі інтерфейси, що підходить для більшості ПК. На машині з кількома мережами одночасно — Wi-Fi та Ethernet та VPN — виберіть інтерфейс, на якому фактично знаходяться ваші аудіопристрої, щоб MusicBee рекламував адресу, до якої вони можуть дістатися.
• Port. Змінюйте його лише в тому випадку, якщо інша програма вже використовує порт за замовчуванням, або ваш брандмауер наполягає на певному номері.

Головна причина, чому пристрій "не бачить MusicBee", – це брандмауер, а не UPnP. Брандмауер Windows повинен дозволяти порт MusicBee як для приватного, так і для публічного мережевих профілів, і зазвичай вам доведеться перезапустити MusicBee після зміни правил брандмауера. Перевірте це, перш ніж змінювати щось у плагіні.

Налаштування

Керування	Що це робить
IP-адреса	До якого мережевого інтерфейсу прив'язується сервер; "Automatic" використовує всі інтерфейси. Набуває чинності після перезапуску MusicBee.
порт	TCP-порт, на якому прослуховує HTTP-сервер (за замовчуванням 9779). Якщо порт зайнятий, плагін автоматично вибирає вільний. Набуває чинності після перезапуску.

Діагностика

Коли певний пристрій працює некоректно, поведінка плагіна невидима, доки ви її не зафіксуєте. Ці інструменти виконують усі ролі, тому вони знаходяться на власній вкладці Налагодження, а не під однією функцією.

• Записувати налагоджувальну інформацію записує кожен запит, user-agent пристрою та кожне рішення щодо кодека/транскодування до файлу журналу, який можна відкрити за допомогою Переглянути. Увімкніть його під час усунення несправностей (і для виявлення user-agent пристрою для профілю), а потім знову вимкніть — журнал швидко зростає. Ви також можете очищати його при кожному запуску.
• Мережа обмежена пропускною здатністю (Відтворення) повідомляє плагіну, що кожного разу, коли він виконує транскодування, він повинен використовувати втратний вихідний формат профілю пристрою (MP3/AAC/Ogg), а не великий безвтратний. Увімкніть його для повільних Wi-Fi з'єднань.
• Вкладка Налагодження також містить низькорівневі інструменти запитів, призначені для розробки; ви можете ігнорувати їх при звичайному використанні (див. Інші налаштування).

Для щоденної діагностики шаблон такий: увімкнути ведення журналу → відтворити проблему → прочитати журнал → налаштувати відповідний профіль пристрою → вимкнути ведення журналу.

Налаштування

Елемент керування	Що він робить
Записувати налагоджувальну інформацію	Записує кожен запит, user-agent та рішення щодо кодека до файлу. Увімкнено під час усунення несправностей, вимкнено в іншому випадку.
Очищати журнал при запуску плагіна	Очищає журнал кожного разу, коли запускається плагін.
Переглянути	Відкриває поточний файл журналу.
Очистити журнал	Очищає журнал зараз.
Мережа обмежена пропускною здатністю - транскодувати вихідний потік у формат зі втратами, встановлений у профілі пристрою вище	Коли відбувається транскодування, використовуйте втратний вихідний формат профілю пристрою. Для повільних з'єднань. Потрібен втратний формат, обраний у розділі транскодування профілю.

Швидке усунення несправностей

Симптом	Що спробувати в першу чергу
Пристрій взагалі не бачить MusicBee	Перевірте брандмауер Windows для обох приватних і публічних мереж; порт плагіна (за замовчуванням 9779) має бути доступним. Перезапустіть MusicBee після змін у брандмауері.
Джерело (Подкасти, Радіо, Вхідні…) відсутнє в дереві	Ймовірно, воно приховане. На вкладці Вигляд позначте вузол і переконайтеся, що його прапорець Видимий увімкнений.
Вузол переглядається з неправильною формою	Застосуйте інший шлях виявлення на вкладці Вигляд — наприклад, Плоскі доріжки для списку відтворення, Виконавець альбому → Альбом → Доріжки для музичного фільтра.
Пристрій бачить MusicBee, але не відтворює жодної доріжки	Профіль пристрою, ймовірно, неправильний, або примусовий нативний потік вимкнений, і транскодування не вдається. Позначте примусовий нативний потік у профілі цього пристрою та повторіть спробу.
Аудіо відтворюється як статичний шум / білий шум	Спробуйте примусовий little endian для PCM потоків у профілі пристрою. Якщо це не допоможе, спробуйте не використовувати RAW PCM.
Проміжки між доріжками	Справжнє безперервне відтворення автоматично працює на пристроях, що підтримують NextURI. Якщо ви все ще чуєте проміжки, пристрій або не підтримує його, або його реалізація є помилковою — поверніться до виведення як безперервного потоку (безперервне відтворення гарантоване, але інформація про доріжку та елементи керування наступним/попереднім перестають працювати).
EQ / DSP / ReplayGain "нічого не робить"	Примусовий нативний потік увімкнений для цього пристрою — він має пріоритет. Зніміть прапорець примусовий нативний потік у профілі пристрою. Дивіться Транскодувати чи ні.
Сучасний (2020+) пристрій ігнорує елементи керування MusicBee	Виправлення для пристроїв, що рекламуються як MediaRenderer:2/3, знаходиться в цьому форку; воно повинно працювати. Якщо ні, захопіть журнал налагодження та подайте проблему.
Плагін завантажується, але Налаштувати не відкривається	Перевірте ErrorLog.dat MusicBee — плагін, ймовірно, аварійно завершив роботу під час завантаження. Видалення файлу налаштувань плагіна та повторне налаштування зазвичай вирішує проблему.
Мови, крім англійської	Плагін підтримує 22 мови та відповідає власній мові MusicBee, і ця довідка доступна всіма ними. Щоб використовувати іншу мову, встановіть мову на вкладці Загальні.

Наскільки це було протестовано

Щоб ніщо вас не здивувало, ось чесна інформація про те, наскільки плагін використовувався в реальних умовах.

Усе тестувалося з BubbleUPnP, а foobar2000 використовувався як другий еталон. Усі три ролі працюють там — але BubbleUPnP є єдиним аналогом, з яким плагін був перевірений, тому інші програми керування, інші плеєри та пристрої для перегляду, крім цих двох, не тестувалися і потребуватимуть тестування спільнотою.

На практиці це найважливіше при відтворенні на фізичний стрімер (роль точки керування). Справжні безперервні переходи між треками були підтверджені на BubbleUPnP, але реальні стрімери — WiiM, Sonos, Cambridge, Eversolo, Marantz, Denon — кожен обробляє передачу між треками трохи по-різному, і жоден з них не був протестований на реальному обладнанні. Якщо безперервне відтворення поводиться неправильно на одному з них, вимкніть NextURI для цього пристрою, щоб він повернувся до відтворення одного треку за раз.

Інші налаштування

Кілька елементів керування не належать до жодної функції:

Елемент керування	Що він робить
Довідка	Відкриває цю сторінку довідки у вашому веб-браузері мовою MusicBee (з поверненням до англійської, якщо переклад ще не готовий).
Прочитати останній запит, Виконати запит, Отримати теги для перших 5	Низькорівневі інструменти запитів на вкладці Налагодження, призначені для розробки; ігноруйте їх при звичайному використанні.
Зберегти	Зберігає зміни. Налаштування, які прив'язуються під час запуску (порт, IP, максимальна кількість з'єднань, рендерер), відображають значок ⚠ Потрібен перезапуск, доки ви не перезапустите MusicBee.
Скасувати	Закриває діалогове вікно без збереження.

Подяки

• Оригінальний плагін від Steven Mayall. Цей форк переписав перегляд бібліотеки та діалогове вікно налаштувань, а також додав рендерер, але ядро UPnP, HTTP та SSDP, на якому все це базується, значною мірою залишається його кодом.
• Закритий форк UPnP 2025 від BoringName, чия публічна тема на форумі надала каталог помилок.