Audio Call

audiocall은 1:1 전화 기능을 인터넷을 이용한 애플리케이션으로 구현한 것입니다. 통화 발신자는 caller, 착신자를 callee라는 통신 용어로 구분합니다. Omnitalk SDK를 사용하여 offerCall(), answerCall()을 각각 호출하고 해당 이벤트 메시지에 대응하는 것으로 전화 기능을 간단히 구현할 수 있습니다.

Call Flow 에서는 audiocall의 흐름을 sequence diagram으로 보여줍니다.

Step 1. 세션 생성

Omnitalk SDK의 초기화를 제외한 모든 API를 사용하기 위해서는 우선적으로 createSession()을 호출하여 세션을 생성해야 합니다. createSession()의 파라미터인 user_id는 사용자를 구분하기 위한 고유한 id이며 audiocall 발신을 위한 offerCall() 호출에 사용됩니다. user_id는 Optional 이며, 생략시 Omnitalk 서버에서 임의의 id를 부여합니다.

await sdk.createSession(user_id);

Step 2. 발신

callee의 user_id를 모르는 경우

수신자의 user_id를 모르는 경우는 sessionList() API로 사용자 목록을 조회할 수 있습니다. 해당 API는 현재 연결중인 모든 사용자 목록을 조회할 수 있습니다(동일한 Service Id로 생성된 사용자 목록). idle state의 사용자에게 전화 요청을 할 수 있습니다.

callee의 user_id를 아는 경우

해당 user_id의 사용자가 idle state인 경우 전화 요청을 할 수 있습니다.

offerCall() API로 전화 요청을 할 수 있습니다. 파라미터로 call_type, callee의 user_id, 녹음 여부를 전달하면 됩니다.

  • call_type: 전화 타입을 의미합니다. CALL_TYPE은 Omnitalk SDK에서 enum type으로 제공합니다. 음성 통화를 위해서는 audiocall 을 전달하시면 됩니다.

  • callee: 위에서 얻은 callee의 user_id를 전달하시면 됩니다.

  • record: Optional 파라미터로, 녹음 여부를 의미합니다. defalut = false

await sdk.offerCall(CALL_TYPE.AUDIO_CALL, callee, true);

offerCall 호출 성공시 caller는 RINGBACK_EVEVT, callee는 RINGING_EVENT를 수신합니다.

Step 3. 수신

callee가 RINGING_EVENT를 받은 경우

callee가 세션을 생성한 상태에서 caller가 offerCall(전화 요청)을 하여RINGING_EVENT를 받은 경우, callee는 별도의 파라미터를 전달하지 않고 answerCall()을 호출하여 전화를 수신할 수 있습니다. 수신 거절을 하고싶은 경우 leave()를 호출하시면 됩니다.

await sdk.answerCall();

callee가 전화 요청(offerCall) 이후에 session을 생성한 경우

callee가 세션을 생성하기 전 caller가 offerCall(전화 요청)을 하여 RINGING_EVENT를 받지 못한 경우, callee는 answerCall()의 파라미터에 call_type과 caller를 전달하여 전화를 수신할 수 있습니다. 이 경우, 애플리케이션에서 callee 에게 call_type과 caller를 전달해 주어야 합니다.

  • call_type: 전화 타입을 의미합니다. caller가 offerCall()을 호출할 때와 동일하게 audiocall 을 전달하시면 됩니다.

  • caller: caller(전화 발신자)의 user_id를 전달하시면 됩니다.

await sdk.answerCall(CALL_TYPE.AUDIO_CALL, caller);

Step 4. 연결 성공

음성 통화 연결이 성공하면 caller, callee 양측 모두 CONNECTED_EVENT 를 수신합니다.

Step 5. 전화 끊기

leave() API를 통해서 전화 연결을 끊을 수 있습니다.

await sdk.leave();

오디오 장치 제어

mute/unmute

전화 통화중에 음소거를 할 수 있도록 API를 제공합니다. 사용법과 자세한 내용은 API Reference의 mute/unmute 부분을 참조 바랍니다. mute/unmute API의 파라미터인 track type은 Omnitalk SDK에서 enum type으로 제공합니다. 예시는 아래와 같습니다.

await sdk.setMute(TRACK_TYPE.AUDIO);

입력 장치 변경

전화 연결 전, 또는 전화 통화중에 입력(마이크) 장치를 변경할 수 있도록 API를 제공합니다.

  1. 우선, 사용 가능한 입력 장치 목록을 조회할 수 있는 getDeviceList() 를 통해서 사용하고자 하는 장치의 deviceId를 획득합니다.

  2. setAudioDevice() 파라미터로 deviceId를 전달하여 입력 장치를 변경할 수 있습니다.

PreviousPre-requisiteNextVideo Call

Last updated