실시간 스트리밍 인식 문제

Classic/VPC 환경에서 이용 가능합니다.

CLOVA Speech 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 질문과 답변을 확인하고 적절하게 조치해 주십시오.

extraContents 필드 내 epFlag, seqId 용도

인식(Recognize) API의 extraContents 필드에서 epFlag와 seqId의 용도를 알고 싶습니다.

해결 방법

일시 정지를 목적으로 활용하거나, 보낸 요청에 대한 응답을 다 받았는지 확인하는 용도로 사용할 수 있습니다.

gRPC 서비스 일시 정지 기능 지원 여부

gRPC 서비스에서 일시 정지 기능을 지원하는지 알고 싶습니다.

해결 방법

일시 정지 기능은 제공하지 않습니다. 그러나 인식(Recognize) API에서 extraContents 필드의 epFlag 항목을 true로 설정하고 요청을 전송한 뒤, 일정 시간 동안 인식(Recognize) 요청을 하지 않는 방법으로 구현이 가능합니다. epFlag 항목에 대한 자세한 설명은 CLOVA Speech 실시간 스트리밍 API를 참조해 주십시오.

• epFlag를 true로 설정하지 않고 인식(Recognize)를 요청하다가 일정 시간 동안 재요청을 하지 않을 경우, 서버 내부에서 설정된 unvoiceTime(10초)을 기반으로 버퍼링되어 있는 인식 요청을 처리하여 응답 결과를 표시합니다.

인식(Recognize) API 음원 데이터 형식

인식(Recognize) API의 음원 데이터 형식에 대해 알고 싶습니다.

해결 방법

현재 16 kHz, 1 channel, 16 bits per sample의 PCM (헤더가 없는 raw wave) 형식만 지원합니다.

종료(Close) API 호출 전 epFlag 값 true 필수 여부

종료(Close) API를 호출하기 전, 인식(Recognize) API의 extraContents에 epFlag 항목을 반드시 true로 설정해야 하는지 알고 싶습니다.

해결 방법

반드시 epFlag 항목을 true로 설정할 필요는 없습니다. 그러나 마지막 인식(Recognize) 요청에 대해 빠른 응답 결과를 받고 싶은 경우 epFlag 항목을 true로 설정하는 것이 좋습니다. epFlag 항목에 대한 자세한 설명은 CLOVA Speech 실시간 스트리밍 API를 참조해 주십시오.

모든 응답 회신 여부

보낸 요청에 대한 모든 응답을 받았는지 확인하고 싶습니다.

해결 방법

인식(Recognize) API를 호출할 때, extraContents 필드의 epFlag와 seqId 항목을 활용할 수 있습니다. epFlag 항목을 true로 설정하고, seqId 항목을 0이 아닌 임의의 값으로 설정한 인식(Recognize) 요청의 처리 결과는 인식(Recognize) 응답의 epFlag, seqId를 비교함으로써 확인할 수 있습니다. 자세한 설명은 Recognize 응답의 JSON 응답 바디를 참조해 주십시오.

gRPC 서비스의 Connection Lifetime 제한 여부

gRPC 서비스의 Connection Lifetime(서버와 클라이언트의 연결 지속 시간)에 제한이 있는지 알고 싶습니다.

해결 방법

gRPC 서비스는 Connection Lifetime 제한을 100 시간으로 설정하고 있으나 네트워크 문제 등으로 끊김이 발생할 수 있으므로 안정적인 서비스 이용을 위해 retry(재연결) 로직 반영을 권장드립니다.