이 페이지에서는 Live Stream API 관련 문제를 해결하는 방법을 설명합니다. 이 페이지에 표시된 오류는 Live Stream API와 관련이 있습니다. Google API의 일반적인 오류는 Cloud API 오류 페이지를 참조하세요.
입력 스트림이 거부됨
인코더에서 입력 스트림을 입력 엔드포인트로 전송했지만 연결이 계속 거부되는 경우에는 다음과 같은 문제가 있는지 확인합니다.
잘못된 입력 엔드포인트 URI
인코더에서 입력 스트림을 잘못된 입력 엔드포인트 URI로 전송하면 이 오류가 발생합니다.
이 문제를 해결하려면 인코더에서 입력 스트림을 올바른 IP 주소와 STREAM-ID가 있는 입력 엔드포인트 URI로 전송하도록 구성되었는지 확인합니다.
입력이 채널에 연결되지 않음
인코더에서 입력 스트림을 채널에 연결되지 않은 입력 엔드포인트 URI로 전송하면 이 오류가 발생합니다.
이 문제를 해결하려면 입력 엔드포인트가 있는 새 채널을 만듭니다. 입력 엔드포인트가 채널에 성공적으로 연결되었는지 확인하려면 채널 세부정보를 가져오고 inputAttachments 필드에서 입력 엔드포인트 이름을 찾습니다.
비활성 채널
인코더에서 입력 스트림을 실행되지 않고 있는 채널에 전송하면 이 오류가 발생합니다.
이 문제를 해결하려면 채널의 상태를 확인하여 streamingState가 AWAITING_INPUT인지 확인하세요. 채널의 streamingState가 STOPPED이면 채널을 시작합니다.
다른 인코더가 동일한 입력 엔드포인트에 이미 연결되어 있음
여러 인코더에서 입력 스트림을 동일한 입력 엔드포인트로 전송하려고 하면 이 오류가 발생합니다. 입력 엔드포인트 URI당 한 번에 연결 하나만 허용됩니다.
이 문제를 해결하려면 채널이 이미 STREAMING 상태인지 확인하세요. 이 경우 다음 옵션을 사용할 수 있습니다.
두 번째 입력 스트림에 대한 별도의 입력 엔드포인트와 채널을 만듭니다.
동일한 입력 엔드포인트에 다른 입력 스트림을 보내기 전에 첫 번째 입력 스트림을 중지합니다.
인코더 IP 주소가 허용된 IP 범위에 없음
인코더가 입력 엔드포인트에 지정된 IP 범위 밖의 IP 주소에서 입력 스트림을 전송하면 이 오류가 발생합니다.
이 문제를 해결하려면 입력 엔드포인트의 세부정보를 가져오고 securityRules 필드를 확인합니다. ipRanges가 지정된 경우 해당 IP 범위에 유효한 IP 주소가 인코더에 있는지 확인합니다.
Cloud Storage 버킷에 출력 파일 누락
인코더에서 입력 스트림을 성공적으로 입력 엔드포인트에 전송했지만 Cloud Storage 버킷에 출력 파일이 표시되지 않는 경우 다음과 같은 가능한 문제가 있는지 확인합니다.
잘못된 Cloud Storage 버킷
잘못된 Cloud Storage 버킷을 확인하면 출력 파일이 누락될 수 있습니다.
이 문제를 해결하려면 실시간 스트림의 채널 세부정보를 가져옵니다. output.uri 필드를 확인하여 올바른 Cloud Storage 버킷 URI를 확인합니다.
잘못된 입력 동영상/오디오 코덱
인코더에서 잘못된 동영상 및 오디오 코덱을 전송하면 출력 파일이 누락될 수 있습니다.
이 문제를 해결하려면 인코더에서 H264 동영상 및 AAC 오디오 코덱만 전송하도록 합니다.
Cloud Storage 권한이 거부됨
기본적으로 Live Stream API는 Live Stream API 리소스를 호스팅하는 동일한 Google Cloud 프로젝트의 Cloud Storage 버킷에 액세스할 수 있는 서비스 계정을 만듭니다. 이 서비스 계정에서 Cloud Storage 버킷에 액세스할 수 있는 권한을 손실하면 출력 파일이 누락될 수 있습니다.
이 문제를 해결하려면 서비스 계정에 충분한 권한이 있는지 확인합니다. 다음과 같은 이유로 출력 파일이 생성되지 않을 수 있습니다.
출력 Cloud Storage 버킷은 채널 및 입력 엔드포인트와 같은 Live Stream API 리소스와 다른 Google Cloud 프로젝트에 있습니다.
서비스 계정에서 기본 권한이 취소됩니다.
자세한 내용은 Cloud Storage에 액세스를 참조하세요.
오디오 트랙 누락
인코더에서 오디오 트랙이 누락된 입력 스트림을 전송하면 출력 파일이 누락될 수 있습니다. 동영상 파이프라인은 처리가 시작되기 전에 모든 오디오 트랙이 도착할 때까지 기다립니다.
이 문제를 해결하려면 실시간 스트림의 채널 세부정보를 가져옵니다. 인코더가 ElementaryStream.audioStream.mapping(AudioMapping) 필드에 구성된 모든 오디오 트랙을 전송하는지 확인합니다.