미로
OpenAI Python SDK, Live 보조 채널 이벤트에 타입 추가
기존 보조 연결 이벤트를 타입으로 다룹니다
OpenAI Python SDK 3.35.0은 한국시간 2026년 10월 18일 공개됐습니다. Live의 sideband 연결에서 전달되는 입력·출력 음성과 전송 상태 이벤트에 타입 지원을 추가합니다. 새 음성 모델이나 통화 품질 개선을 발표한 변경이 아니라, 이미 있는 이벤트 변형을 SDK에서 명확하게 읽게 하는 변화입니다.
PR #4099는 일곱 이벤트 변형을 추가하면서 기존 공개 이벤트 클래스와 알 수 없는 이벤트 처리를 유지한다고 설명합니다. 연결 런타임과 API 도우미의 소유 관계, HTTP API, 인증 정책, 복구 동작은 그대로입니다.
음성과 통화 상태를 나누어 읽습니다
추가 범위에는 주 연결에서 반영된 입력 음성과 출력 음성, DTMF 수신·전송, ringing·answered·failed 상태가 포함됩니다. DTMF는 전화 키패드 신호를 다루는 이벤트입니다. 텍스트 응답만 처리하는 반복문과는 다른 분기와 데이터 취급이 필요할 수 있습니다.
특히 입력 음성 타입의 설명은 주 전송에서 받은 오디오가 모델 입력 음소거 전에 보조 연결로 반영된다고 명시합니다. 모델에 음소거된 입력이라는 이유만으로 보조 연결에도 음성 데이터가 없다고 가정해서는 안 됩니다. 기록이나 디버깅을 설계할 때 이 전달 범위를 확인할 필요가 있습니다.
typed 이벤트가 자동 동작을 만드는 것은 아닙니다
새 클래스를 받는다고 앱이 자동으로 음성을 재생하거나 통화 상태 화면을 갱신하는 것은 아닙니다. ringing, answered, failed를 어떤 UI와 운영 상태에 연결할지는 앱이 결정합니다. 한 상태 이벤트를 다른 작업의 성공으로 간주하지 않도록 의미를 구분해야 합니다.
알 수 없는 이벤트가 유지된다는 점도 중요합니다. 전체 타입 목록만을 전제로 처리하다가 새 이벤트를 만나 연결을 중단하지 않도록, 미지원 이벤트를 안전하게 기록하거나 무시하는 흐름을 검토할 수 있습니다. 다만 민감한 오디오 페이로드까지 로그에 그대로 남길 필요는 없습니다.
로컬 검증과 실제 서비스 검증을 구분합니다
PR은 소스와 설치된 wheel에서 동기·비동기 보조 연결 테스트를 수행했다고 설명합니다. 일곱 변형과 client_event_id의 null·생략, 알 수 없는 이벤트, 자원 정리를 포함하지만 호스팅 서비스 시험은 보류된 상태라고 밝힙니다.
프로젝트에서는 합성 이벤트로 상태 전환과 정리를 먼저 확인하고, 실제 서비스 사용 권한과 조건은 별도로 점검해 보세요. 종료 뒤 처리기가 남아 중복 재생하거나 알림을 반복하지 않는지도 확인할 만합니다. 이 글은 타입과 PR 검토이며 실제 통화 연결, 음성 수집 또는 재생 시험을 수행한 결과는 아닙니다.
댓글
이 글에 대한 생각을 남겨 주세요.