Устранение неполадок со Службами мультимедиа
Предупреждение
Поддержка Служб мультимедиа Azure будет прекращена 30 июня 2024 г. Дополнительные сведения см. в руководстве по прекращению поддержки AMS.
Находите причины и решения проблем со Службами мультимедиа.
Примечание
Многие проблемы можно устранить путем миграции в API Служб мультимедиа версии 3 или с помощью руководства по потоковой трансляции.
Проблемы с учетной записью
| Причина | Решение |
|---|---|
| Возможно, вы пытаетесь использовать функции API версии 3 с учетной записью версии 2 или реализацией API версии 2. | Обновите код, чтобы использовать API версии 3. Дополнительные сведения см. в статье Руководство по миграции. |
Распространенные проблемы с воспроизведением видео
- Видео долго начинает воспроизводиться.
- Видео размыто, когда начинается воспроизведение.
- Качество видео низкое.
- Видео не воспроизводится вообще или отображается черный экран.
| Причина | Решение |
|---|---|
| Возможно, вы пытаетесь охватить большую аудиторию без использования CDN, что вызывает проблемы с задержкой. | Добавьте CDN к указателю потоковой передачи. Дополнительные сведения об использовании CDN см. в статье Потоковая передача содержимого с использованием интеграции CDN. |
| Возможно, вы не реализовали динамическую упаковку. | Дополнительные сведения о реализации динамической упаковки см. в статье Динамическая упаковка в Службах мультимедиа версии 3. |
| У вас могут быть так называемые "шумные соседи", что означает, что вы делитесь вычислительными ресурсами с другими клиентами. | Чтобы избежать "шумных соседей", обновите стандартную конечную точку потоковой передачи до конечной точки потоковой передачи уровня "Премиум" с выделенными единицами потоковой передачи. |
| Возможно, вы используете старый браузер для просмотра видео. | Обновите браузер. |
| Возможно, вы используете сторонние проигрыватель и фильтры. | Добавьте audio-only=false в URL-адрес потоковой передачи (см. https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false)). |
Не удается воспроизвести MP4-файл из ресурса
| Причина | Решение |
|---|---|
| Службы мультимедиа Azure предназначены для использования файла манифеста, а не прямого воспроизведения полноразмерных потоков MP4. Файл манифеста сообщает проигрывателю, какие закодированные фрагменты мультимедиа следует воспроизводить и в каком порядке. | Используйте один из предоставленных кодировщиков мультимедиа для создания фрагментов мультимедиа и файла манифеста. Дополнительные сведения о кодировании см. в статьях Кодирование с поддержкой содержимого и Кодирование с использованием автоматически созданной схемы скоростей. |
| Имя файла содержит зарезервированные знаки. | Удалите зарезервированные знаки из имени файла. |
Зарезервированные знаки
- Службы мультимедиа используют значение имени файла ресурса при создании URL-адресов для потоковой передачи содержимого. По этой причине кодирование с помощью знака процента не допускается. Значение свойства name не может содержать следующие зарезервированные символы: !*'();:@&=+$,/?%#[]". Кроме того, может использоваться только один знак "." для расширения имени файла.
- Длина имени не должна превышать 260 знаков.
Зашифрованное содержимое не будет воспроизводиться в автономном режиме.
| Причина | Решение |
|---|---|
| Проигрыватель, который вы используете для воспроизведения скачанных видео с шифрованием AES в автономном режиме на устройствах iOS, управляет воспроизведением этих видео. Причина не связана со Службами мультимедиа. | Просмотрите документацию по выбранному вами автономному проигрывателю видео. |
Аудио не синхронизируется.
| Причина | Решение |
|---|---|
| Пакеты видео доставляются поздно. | Возможные решения: 1. Возможно, вы реализовали политику управления версиями хранилища, которая была включена автоматически, что приводит к буферизации и отключениям. Удалите политику и отключите автоматическое управление версиями хранилища. 2. Включите CDN. 3. Используйте конечную точку потоковой передачи уровня Premium с достаточным количеством зарезервированных единиц. |
Запрос проигрывателя для VTT-файла вызвал ошибки CORS.
| Причина | Решение |
|---|---|
| Настройка правил CORS | Настройте правила CORS для учетной записи хранения или CDN. |
Вы также можете получить URL-адрес скачивания VTT-файла из ресурса.
Конечная точка потоковой передачи не запускается.
| Причина | Решение |
|---|---|
| Возможно, вы создали пользовательскую политику, которая включает только HTTPS. Сейчас эта возможность не поддерживается Службами мультимедиа. | Возможные обходные пути: 1. На портале Azure отключите пользовательскую политику. 2. Создайте конечную точку потоковой передачи с включенной CDN и отключите HTTP для конечной точки CDN. Or 1. Не включайте CDN для конечной точки потоковой передачи с помощью портала или API. 2. Вместо этого перейдите на страницу Azure CDN на портале Azure или используйте API Azure CDN, чтобы создать конечную точку, указывающую на конечную точку Служб мультимедиа, задав в качестве источника конечной точки CDN имя узла для конечной точки потоковой передачи. |
| Возможно, вы остановили конечную точку потоковой передачи с использованием CDN. | Дополнительные сведения см. в разделе Конечная точка потоковой передачи не запускается. |
Конечная точка потоковой передачи с использованием CDN не останавливается.
| Причина | Решение |
|---|---|
| Когда вы включаете CDN для любой конечной точки потоковой передачи, конечная точка CDN не будет создана, пока вы не запустите конечную точку потоковой передачи. Это связано с тем, что в процессе запуска наша платформа создаст конечные точки CDN и свяжет их с конечной точкой потоковой передачи (включая настройку пользовательского имени узла). Во время процесса остановки для конечной точки потоковой передачи наша платформа должна удалить конечную точку CDN. Поэтому, если конечная точка потоковой передачи находится в состоянии остановки, конечная точка CDN не будет существовать и не будет указывать на конечную точку потоковой передачи. Но в некоторых сценариях, когда AMS вызывает CDN для удаления конечных точек CDN, удалить конечные точки не удается из-за кэшей в CDN. Это приводит к проблеме с конфликтом имен узлов, если конечная точка CDN все еще существует, и вызывает проблему с конечной точкой остановки потоковой передачи. |
Вручную удалите профиль CDN, а затем удалите конечную точку потоковой передачи и настройте новую. |
Конечные точки потоковой передачи не отображаются после перемещения учетной записи в другую подписку.
| Причина | Решение |
|---|---|
| Перемещение конечных точек потоковой передачи в новую подписку занимает некоторое время. | Подождите 2 часа и убедитесь, что ваши конечные точки потоковой передачи отображаются в новой подписке. |
Локальный кодировщик не отправляет данные в трансляцию.
| Причина | Решение |
|---|---|
| Возможно, вы используете кодировщик, который не был протестирован со Службами мультимедиа. | Дополнительные сведения см. в статье Проверенные локальные кодировщики потоковой трансляции. |
| Локальный кодировщик может быть настроен неправильно. | Убедитесь, что вы правильно настроили локальный кодировщик. |
Кодировка долго выполняется.
Большинство проблем с длительностью кодирования можно решить, настроив параметры кодировщика для определения баланса между скоростью и качеством. Для ускорения кодирования включите режим Скорость.
| Причина | Решение |
|---|---|
| Мезонинный файл может быть очень большим. Размер файла равен скорости, умноженной на длительность. | None |
| Существует большое количество уровней вывода. | Уменьшите количество уровней вывода. |
| Уровни вывода имеют высокое разрешение. | Уменьшите разрешение уровня вывода до той скорости с которой вы собираетесь осуществлять потоковую передачу мультимедиа. |
| Мезонинный файл может быть сложным, особенно если вы кодируете файл с разрешением 4k. | None |
Сбои преобразования
| Причина | Решение |
|---|---|
| Возможно, вы превысили квоту на преобразования на учетную запись, которая составляет 100. | Удалите неиспользуемые преобразования. |
Не удается отправить мультимедиа
Не удается отправить мультимедиа в учетную запись хранения.
| Причина | Решение |
|---|---|
| Вы пытаетесь использовать HTTP. | Использовать HTTPS. Протокол HTTP больше не поддерживается для отправки содержимого. |
| Вы недостаточно долго ждете развертывания учетной записи хранения. | Если вы создали учетную запись хранения программными средствами, добавьте код для проверки того, что учетная запись хранения развернута, прежде чем пытаться отправить мультимедиа. |
Проблемы с CORS
| Причина | Решение |
|---|---|
| Если вы пытаетесь использовать предварительные запросы, содержащие заголовки traceparent, вы получите ошибки CORS. Сейчас Службы мультимедиа не поддерживают предварительные запросы. | Мы знаем, что предварительные запросы являются важной возможностью для наших клиентов. Не используйте предварительные запросы, пока эта функция не станет доступной. |
Проблемы с подключением к учетной записи хранения
Состояние "Отключено"
Состояние "Отключено" учетной записи Служб мультимедиа указывает, что эта учетная запись больше не имеет доступа к одной или нескольким подключенным учетным записям хранения из-за изменения ключей доступа к хранилищу. Ключи доступа к хранилищу в актуальном состоянии необходимы Службам мультимедиа для выполнения различных задач в учетной записи.
Ниже приведены основные сценарии, которые могут лишить учетную запись Служб мультимедиа доступа к подключенным учетным записям хранения.
| Причина | Решение |
|---|---|
| Учетная запись Служб мультимедиа или подключенные учетные записи хранения были перенесены в отдельные подписки. | Перенесите учетные записи хранения или учетные записи Служб мультимедиа, чтобы они все находились в одной подписке, или используйте управляемое удостоверение для проверки подлинности учетной записи хранения, если ваша учетная запись хранения находится в том же арендаторе. |
| Учетная запись Служб мультимедиа использует подключенную учетную запись хранения в другой подписке, так как это ранняя учетная запись Служб мультимедиа, которая была создана, когда такая возможность поддерживалась. Все раннее учетные записи Служб мультимедиа были преобразованы в современные учетные записи на основе Azure Resource Manager и находятся в отключенном состоянии. | Перенесите учетную запись хранения или учетную запись Служб мультимедиа, чтобы они все находились в одной подписке, или используйте управляемое удостоверение для проверки подлинности учетной записи хранения, если ваша учетная запись хранения находится в том же арендаторе. |
Учетная запись Служб мультимедиа не может получить доступ к учетной записи хранения
| Причина | Решение |
|---|---|
| Управляемому удостоверению Служб мультимедиа не назначена роль участника данных BLOB-объектов хранилища. | Чтобы проверить это на портале Azure, сначала узнайте, какое удостоверение задано для учетной записи хранения, выбрав "Учетные записи хранения" в меню учетной записи Служб мультимедиа. Там должно быть указано "Назначаемое системой" или имя управляемого удостоверения, назначаемого пользователем. Затем перейдите к учетной записи хранения на портале, выберите в меню "Контроль доступа (IAM)", щелкните "Назначения ролей" на панели инструментов, а затем добавьте назначение роли. При этом для роли необходимо задать значение "Участник данных BLOB-объектов хранилища", а участники должны иметь управляемое удостоверение, используемое учетной записью Служб мультимедиа для доступа к учетной записи хранения. Когда назначение роли будет добавлено, может потребоваться несколько минут, чтобы изменения вступили в силу. |
Azure Media Indexer 2 не возвращается в списке обработчиков мультимедиа.
| Причина | Решение |
|---|---|
| Поддержка Azure Media Indexer 2 прекращена 1 января 2020 г. | Перейдите на использование API Служб мультимедиа версии 3. |
Ошибка сети привела к частичному сбою скачивания видео.
| Причина | Решение |
|---|---|
| Эта ошибка обычно является результатом проблем с сетевым подключением на стороне клиента, а не со Службами мультимедиа. | Обратитесь к сетевому администратору или используйте отладку браузера Fiddler или F12, чтобы увидеть основную ошибку. |
Проблемы со скачиванием
Отображается следующее сообщение об ошибке:
"При попытке скачать входные файлы были недоступны. Проверьте доступность источника".
| Причина | Решение |
|---|---|
| Если вы используете токен SAS для доступа к файлу, возможно, срок его действия истек. | Настройте код, чтобы гарантировать, что срок действия токена не истек, прежде чем использовать его для аутентификации. |
Чрезмерные и периодические ошибки 5xx
| Причина | Решение |
|---|---|
| Локальное кодирование могло быть реализовано неправильно. | Убедитесь, что кодировщик настроен правильно. |
| Возможно, вы используете не протестированный локальный кодировщик. | Используйте проверенный локальный кодировщик и убедитесь, что он настроен правильно. |
| Соотношение кэширования между конечной точкой потоковой передачи и CDN может быть недостаточным. | 1. Настройте соотношение кэширования таким образом, чтобы CDN обрабатывала больше трафика. 2. Настройте правило оптимизации потоковой передачи для CDN. |
| Возможно, конфигурация прокси-сервера неправильная. | Убедитесь, что фильтры настроены правильно. |
Дополнительные сведения см. в статье Рекомендации по потоковым трансляциям.
Общие ошибки кода
В коде могут возникать ошибки, которые не описаны в справочниках по кодам ошибок конечной точки потоковой передачи, кодам шибок трансляции и кодам ошибок задания.
| Причина | Решение |
|---|---|
| Возможно, вы пытаетесь использовать объект, свойство или метод, которые не включены в более раннюю версию API. | Обновите библиотеку API в среде разработки. |
Если решение проблемы не найдено, обратитесь в службу поддержки Служб мультимедиа.
Справка и поддержка
Вы можете обратиться к Службам мультимедиа с вопросами или следить за нашими обновлениями одним из следующих способов:
- ВОПРОСЫ И ОТВЕТЫ
- Stack Overflow. Пометьте вопросы с помощью
azure-media-services. - @MSFTAzureMedia или используйте @AzureSupport для запроса на поддержку.
- Отправьте запрос в службу поддержки через портал Azure.