Hyperity Video SDK는 여러분의 앱에 아주 쉽고 간단하게 화상통화기능을 추가할 수 있습니다. 여기서는 Hyperity SDK의 기본적인 사용방법에 대한 가이드를 제공하고, 첫 통화를 위한 튜토리얼을 제공합니다.

Step 1: Project 내에서 Hyperity Video SDK를 초기화

첫째, 앱 시작시에 HyperCall 인스턴스를 생성해야 합니다. HyperCall을 초기화 하기 위해서는 아래와 같이 진행하세요

HyperCall.create() 로부터 얻은 인스턴스는 클라이언트 앱 내에서 singleton으로 한번만 호출해서 관리되어야 합니다.

var call = HyperCall.create();

Step 2: 사용자 토큰을 이용한 인증

서비스 토큰을 이용한 인증 기능은 지원 예정입니다

Step 3: 이벤트 핸들러 등록

HyperCall의 간단한 코드만으로 기본적인 통신 및 방송이 가능 합니다. 사용자의 필요에 따라 UI처리 및 추가 작업이 필요한 경우가 발생 합니다. 아래의 다양한 이벤트 핸들러를 통해 보다 세부적인 제어가 가능합니다.

Hyperity Video는 화상통신에 적합한 event들을 가지고 있습니다. 이를 알아두면 각 상황 별 event를 활용하는데 도움이 됩니다. 이에 대한 내용은 아래를 참고하세요.

onConnect

서버 접속 및 채널 생성이 완료된 이후 호출되는 콜백입니다. 실질적으로 채널을 만들어 통화를 요청하는 Caller이거나 만들어진 채널에 접속하여 요청에 응답하는 Callee일때의 동작을 달리 하는 경우가 많으며 개발자가 Caller, Callee여부에 대한 상태를 관리해야 합니다.

Caller는 join()을 통해 채널을 새로 만들고 상대방이 입장하기를 기다립니다.

Callee는 join()을 통해 이미 만들어진 채널에 접속하게 됩니다. 이때 Caller가 만든 채널의 이름을 필수로 필요하게 됩니다. 정상적으로 완료되면 onConnect가 생기나, Callee라면 곧바로 발생하는 onComplete를 사용하는것을 권장합니다.