Media Services 문제 해결

  • 아티클

Media Services 로고 v3

경고

Azure Media Services는 2024년 6월 30일에 사용 중지됩니다. 자세한 내용은 AMS 사용 중지 가이드를 참조하세요.

Media Services 관련 문제의 원인과 솔루션을 찾습니다.

참고

Media Services v3 API로 마이그레이션하거나 라이브 스트리밍 모범 사례 가이드를 참조하여 많은 문제를 해결할 수 있습니다.

계정 문제

원인 해결 방법
v2 계정 또는 v2 API 구현에서 v3 API의 기능을 사용하려고 할 수 있습니다. v3 API를 사용하도록 코드를 업데이트합니다. 자세한 지원 정보는 마이그레이션 가이드를 참조하세요.

일반적인 비디오 재생 문제

  • 비디오 재생이 시작될 때까지 시간이 오래 걸립니다.
  • 비디오가 재생되기 시작할 때 흐리게 표시됩니다.
  • 비디오 품질이 낮습니다.
  • 비디오가 전혀 재생되지 않거나 검은색 화면이 표시됩니다.
원인 해결 방법
대기 시간 문제를 일으키는 CDN을 사용하지 않고 많은 대상 그룹에 도달하려고 할 수 있습니다. 스트리밍 로케이터에 CDN 추가 CDN 사용에 대한 자세한 내용은 CDN 통합을 사용하여 콘텐츠 스트리밍을 참조하세요.
동적 패키징을 구현하지 않았을 수 있습니다. 동적 패키징 구현에 대한 자세한 내용은 Media Services v3의 동적 패키징을 참조하세요.
컴퓨팅 리소스를 다른 고객과 공유하고 있다는 의미의 "노이지 네이버"라고 하는 항목이 있을 수 있습니다. "노이지 네이버"를 방지하려면 표준 스트리밍 엔드포인트에서 전용 스트리밍 단위가 있는 프리미엄 스트리밍 엔드포인트로 업그레이드하세요.
비디오 시청에 이전 브라우저를 사용 중일 수 있습니다. 브라우저를 업그레이드하세요.
타사 플레이어 및 필터를 사용 중일 수 있습니다. https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false)처럼 되도록 스트리밍 URL에 audio-only=false를 추가합니다.

자산에서 MP4 파일을 재생할 수 없음

원인 해결 방법
Azure Media Services는 전체 크기 MP4 스트림을 직접 재생하는 대신 매니페스트 파일을 사용하도록 설계되었습니다. 매니페스트 파일은 플레이어에게 재생할 인코딩된 미디어 조각과 순서를 알려줍니다. 제공된 미디어 인코더 중 하나를 사용하여 미디어 조각 및 매니페스트 파일을 만듭니다. 인코딩에 대한 자세한 내용은 콘텐츠 인식 인코딩 및 자동 생성된 비트 전송률 사다리로 인코딩을 참조하세요.
파일 이름에 예약된 문자 포함되어 있습니다. 파일 이름에서 예약된 문자를 제거합니다.

예약 문자

  • Media Services는 스트리밍 콘텐츠의 URL을 작성할 때 자산 파일 이름의 값을 사용합니다. 이러한 이유로 퍼센트 인코딩은 허용되지 않습니다. name 속성 값에는 %-encoding-reserved 문자 !*'();:@&=+$,/?%#[]"이(가) 있을 수 없습니다. 또한 파일 이름 확장명에는 ‘.’ 하나만 사용할 수 있습니다.
  • 이름 길이는 260자보다 클 수 없습니다.

암호화된 콘텐츠는 오프라인 모드에서 재생되지 않습니다.

원인 해결 방법
iOS 디바이스에서 다운로드한 AES 암호화 비디오를 오프라인 모드로 재생하는 데 사용하는 플레이어는 비디오 재생 방식을 처리합니다. 원인은 Media Services가 아닙니다. 선택한 오프라인 비디오 플레이어에 대한 설명서를 검토하세요.

오디오가 동기화되지 않습니다.

원인 해결 방법
비디오 패킷이 늦게 배달됩니다. 가능한 해결 방법:

1. 자동으로 켜지는 스토리지 버전 관리 정책을 구현하여 버퍼링 및 연결 끊김이 발생할 수 있습니다. 이 정책을 제거하고 자동 스토리지 버전 관리 기능을 끕니다.
2. CDN 사용하도록 설정합니다.
3. 충분한 예약 단위를 제공하는 프리미엄 스트리밍 엔드포인트를 사용합니다.

플레이어의 VTT 파일 요청으로 인해 CORS 오류가 발생했습니다.

원인 해결 방법
CORS 규칙 설정 스토리지 계정 또는 CDN에 대한 CORS 규칙을 설정합니다.

자산에서 VTT 파일의 다운로드 URL을 가져올 수도 있습니다.

스트리밍 엔드포인트가 시작되지 않습니다.

원인 해결 방법
HTTPS만 사용하도록 설정하는 사용자 지정 정책을 만들었을 수 있습니다. 현재 이 기능은 Media Services에서 지원되지 않습니다. 가능한 해결 방법:
1. Azure Portal에서 사용자 지정 정책을 사용하지 않도록 설정합니다.
2. CDN을 사용하도록 설정된 스트리밍 엔드포인트를 만들고, CDN 엔드포인트에 HTTP를 사용하지 않도록 설정합니다.
Or
1. 포털 또는 API를 사용하여 스트리밍 엔드포인트에 CDN을 사용하도록 설정하지 마세요.
2. 그 대신 Azure Portal에서 Azure CDN 페이지로 이동하거나 Azure CDN API를 사용하여 Media Services 엔드포인트를 가리키는 엔드포인트를 만들고, CDN 엔드포인트의 원본을 스트리밍 엔드포인트의 호스트 이름으로 설정합니다.
CDN을 사용하여 스트리밍 엔드포인트를 중지했을 수 있습니다. 스트리밍 엔드포인트가 중지되지 않음을 참조하세요.

CDN을 사용하는 스트리밍 엔드포인트는 중지되지 않습니다.

원인 해결 방법
스트리밍 엔드포인트에 CDN을 사용하도록 설정하면 스트리밍 엔드포인트를 시작할 때까지 CDN 엔드포인트가 만들어지지 않습니다. 시작 프로세스 중에 플랫폼이 CDN 엔드포인트를 만들어 스트리밍 엔드포인트에 연결(사용자 지정 호스트 이름 구성 포함)하기 때문입니다.

스트리밍 엔드포인트의 중지 프로세스 중에는 플랫폼에서 CDN 엔드포인트를 삭제해야 합니다. 따라서 스트리밍 엔드포인트가 중지 상태이면 CDN 엔드포인트가 없거나 스트리밍 엔드포인트를 가리킵니다.

그러나 일부 시나리오에서는 AMS가 CDN 엔드포인트를 삭제하기 위해 CDN을 호출할 때 CDN의 캐시로 인해 엔드포인트를 삭제하지 못합니다. 이로 인해 CDN 엔드포인트가 여전히 있고 스트리밍 엔드포인트 중지 문제가 트리거되는 경우 호스트 이름 충돌 문제가 발생합니다.		 CDN 프로필을 수동으로 삭제한 다음, 스트리밍 엔드포인트를 삭제하고 새 스트리밍 엔드포인트를 설정합니다.

계정을 다른 구독으로 이동한 후에는 스트리밍 엔드포인트가 표시되지 않습니다.

원인 해결 방법
스트리밍 엔드포인트를 새 구독으로 이동하는 데 시간이 걸립니다. 2시간 동안 기다렸다가 스트리밍 엔드포인트가 새 구독에 표시되는지 확인합니다.

온-프레미스 인코더가 라이브 이벤트에 데이터를 보내지 않습니다.

원인 해결 방법
Media Services에서 테스트를 거치지 않은 인코더를 사용 중일 수 있습니다. 검증된 온-프레미스 라이브 스트리밍 인코더를 참조하세요.
온-프레미스 인코더가 올바르게 구성되지 않았을 수 있습니다. 온-프레미스 인코더를 올바르게 구성했는지 확인합니다.

인코딩이 오래 걸리는 것 같습니다.

대부분의 인코딩 시간 문제는 속도와 품질의 적절한 균형을 유지하도록 인코더 설정을 구성하여 해결할 수 있습니다. 인코딩 속도를 높이려면 속도 모드로 설정합니다.

원인 해결 방법
mezzanine 파일이 너무 큰 것일 수 있습니다. 파일 크기는 비트 전송률에 기간을 곱한 값입니다. 없음
출력 계층이 많습니다. 출력 계층 수를 줄입니다.
출력 계층의 해상도가 높습니다. 출력 계층의 해상도를 미디어를 스트리밍하려는 비트 전송률로 낮춥니다.
특히 4k 해상도 파일을 인코딩하는 경우 mezzanine 파일이 복잡할 수 있습니다. 없음

변환 실패

원인 해결 방법
계정당 변환 할당량(100)을 초과했을 수 있습니다. 사용하지 않는 변환을 삭제합니다.

미디어를 업로드할 수 없습니다.

스토리지 계정에 미디어를 업로드할 수 없습니다.

원인 해결 방법
HTTP를 사용하려고 합니다. HTTPS 사용: HTTP 프로토콜은 더 이상 콘텐츠 업로드를 지원하지 않습니다.
스토리지 계정이 배포될 때까지 충분히 오래 기다리지 않았습니다. 프로그래밍 방식으로 스토리지 계정을 만든 경우 미디어를 업로드하기 전에 스토리지 계정이 배포되었는지 테스트하는 코드를 추가합니다.

CORS 문제

원인 해결 방법
traceparent 헤더가 포함된 실행 전 요청을 사용하려고 하면 CORS 오류가 발생합니다. 현재 Media Services는 실행 전 요청을 지원하지 않습니다. 실행 전 요청이 고객에게 중요하다는 것을 잘 알고 있습니다. 이 기능을 사용할 수 있게 될 때까지 실행 전 요청을 사용하지 마세요.

스토리지 계정 연결 문제

연결이 끊긴 상태

Media Services 계정의 "연결 끊김" 상태는 스토리지 액세스 키가 변경되어 해당 계정이 하나 이상의 연결된 스토리지 계정에 액세스할 수 없는 경우를 나타냅니다. Media Services가 계정에서 많은 작업을 수행하려면 최신 스토리지 액세스 키가 필요합니다.

다음은 연결된 스토리지 계정에 대한 액세스 권한이 Media Services 계정에서 없어지는 주요 시나리오입니다.

원인 솔루션
Media Services 계정이나 연결된 스토리지 계정이 별도의 구독으로 마이그레이션되었습니다. 모든 계정이 동일한 구독에 있도록 스토리지 계정 또는 Media Services 계정을 마이그레이션하거나, 스토리지 계정이 동일한 테넌트에 있는 경우 스토리지 계정 인증에 관리 ID를 사용합니다.
이것이 지원되던 초기 Media Services 계정이기 때문에, Media Services 계정이 다른 구독에 속하는 연결된 스토리지 계정을 사용합니다. 모든 초기 Media Services 계정은 최신 Azure Resources Manager 기반 계정으로 변환되어 연결 끊김 상태가 됩니다. 모든 계정이 동일한 구독에 있도록 스토리지 계정 또는 Media Services 계정을 마이그레이션하거나, 스토리지 계정이 동일한 테넌트에 있는 경우 스토리지 계정 인증에 관리 ID를 사용합니다.

Media Services 계정이 스토리지 계정에 액세스할 수 없음

원인 해결 방법
Media Services 관리 ID에 Storage Blob 데이터 Contributor 역할이 부여되지 않았습니다. Azure Portal에서 이를 확인하려면 먼저 Media Services 계정 메뉴에서 "스토리지 계정"을 선택하여 스토리지 계정에 대해 설정된 ID를 확인합니다. 이 ID는 "시스템 할당" 또는 사용자가 할당한 관리 ID의 이름이어야 합니다. 다음으로 포털의 스토리지 계정으로 이동하고, 메뉴에서 "액세스 제어(IAM)"를 선택하고, 도구 모음에서 "역할 할당"을 선택한 다음, 역할 할당을 추가합니다. 역할 할당을 추가할 때 역할은 "Storage Blob 데이터 Contributor"로 설정되어야 하며, 멤버는 스토리지 계정에 액세스하기 위해 Media Services 계정에서 사용하는 관리 ID로 설정되어야 합니다. 역할 할당을 추가한 후 변경 내용이 적용되는 데 몇 분 정도 걸릴 수 있습니다.

Azure Media Indexer 2는 미디어 프로세서 목록에 반환되지 않습니다.

원인 해결 방법
Azure Media Indexer 2는 2020년 1월 1일부로 더 이상 사용되지 않습니다. Media Services v3 API로 마이그레이션합니다.

네트워크 오류로 인해 비디오 다운로드가 부분적으로 실패했습니다.

원인 해결 방법
이 오류는 일반적으로 Media Services가 아닌 클라이언트 쪽 네트워크 연결 문제로 인해 발생합니다. 네트워크 관리자에게 문의하거나 Fiddler 또는 F12 브라우저 디버깅을 사용하여 기본 오류를 확인합니다.

다운로드 문제

다음과 같은 오류 메시지가 수신될 수 있습니다.

"입력 파일을 다운로드하는 동안 파일에 액세스할 수 없습니다. 원본의 가용성을 확인하세요."

원인 해결 방법
SAS 토큰을 사용하여 파일에 액세스하는 경우 토큰이 만료되었을 수 있습니다. 토큰을 사용하여 인증하기 전에 토큰이 만료되지 않았는지 확인하도록 코드를 조정합니다.

과도하고 일시적인 5xx 오류

원인 해결 방법
온-프레미스 인코딩이 잘못 구현되었을 수 있습니다. 인코더가 올바르게 구성되었는지 확인합니다.
테스트를 거치지 않은 온-프레미스 인코더를 사용 중일 수 있습니다. 테스트를 거친 온-프레미스 인코더를 사용하고 해당 인코더가 올바르게 구성되었는지 확인합니다.
스트리밍 엔드포인트와 CDN 간의 캐싱 비율이 충분하지 않을 수 있습니다. 1. CDN이 더 많은 트래픽을 처리할 수 있도록 캐싱 비율을 조정합니다.
2. CDN의 스트리밍 최적화 규칙을 조정합니다.
필터 구성이 잘못되었을 수 있습니다. 필터가 올바르게 구성되었는지 확인합니다.

라이브 스트리밍 모범 사례 가이드를 참조하세요.

일반적인 코드 오류

스트리밍 엔드포인트 오류 코드, 라이브 이벤트 오류 코드 또는 작업 오류 코드 참조에서 다루지 않는 오류가 발생할 수 있습니다.

원인 해결 방법
이전 버전의 API에 포함되지 않은 개체, 속성 또는 메서드를 사용하려고 시도할 수 있습니다. 개발 환경에서 API 라이브러리를 업그레이드합니다.

문제 해결 방법을 찾지 못한 경우 Media Services 고객 지원팀에 문의하세요.

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 질문하거나 업데이트를 따를 수 있습니다.