Skip to main content

​
할 수 있는 일

SDK가 주고받는 값을 찾아봐요. 클라이언트 옵션은 이 페이지에 있고, 명령·이벤트·오류는 각각 상세 페이지로 이어져요. 처음 붙이는 중이면 시작하기를 먼저 보세요.

​
클라이언트 옵션

전부 선택이에요. 생략하면 환경변수를 읽고, 그것도 없으면 기본값을 써요. 옵션 전달 방식은 언어 관례를 따라요. Node는 객체 리터럴, Python은 키워드 인자, Go는 WithURL 같은 함수형 옵션, Java는 ClientConfig예요. Java에서는 openTimeout이 connectTimeoutMillis 하나로 합쳐져 있어요.

​
명령

명령 호출은 프레임을 보내고 바로 반환해요. 통화가 끝날 때까지 기다리려면 waitClosed를 쓰고, 소켓을 닫을 때는 aclose(Node·Python) 또는 Close(Go)를 호출해요. waitClosed는 통화가 종단 상태(call.completed · call.noAnswer · call.failed, 또는 cancelled 상태)에 이르거나 연결이 닫히면 풀려요. 통화를 끝낸 오류가 있으면 그 오류를 다시 던지므로, 거부된 createCall이 멈춘 채 남지 않아요.
requestId는 명령과 응답 프레임을 짝지어 주는 값이에요. 멱등성 키가 아니에요. 같은 requestId로 다시 보내면 명령이 한 번 더 실행돼요.

​
이벤트 · 오류

​
주의사항

  • 에이전트는 서버가 정해요. 명령에 agentId를 넣지 않아요.
  • 한 연결에서 활성 통화는 하나예요.
  • 재연결·세션 재개 프로토콜이 없어요. 비정상 종료는 통화를 처음부터 다시 시작해요.
프레임 계약 전문은 각 SDK 저장소의 docs/protocol/sdk-ws.v1.md에 있어요.

​
관련 문서