Livecast

기본 설정

방송을 하기 전에 각 플렛폼 별 프로젝트 설정을 진행 합니다.

개발

RemonCast 클래스는 방송 생성 및 시청을 위한 기능을 제공합니다. RemonCast 클래스의 create() 함수와 join() 함수를 이용하여 방송 기능을 이용 할 수 있습니다.

전체적인 구성과 흐름은 아래를 참고하세요.

FlowStructure

View 등록

방송 송출자가 스스로의 모습을 확인하거나, 시청자가 방송을 보기 위해서 실제 비디오가 그려지는 View를 정하고 연결해야 됩니다. 방송 송출자에게는 스스로가 보이도록 Local View를 등록 하고, 시청자에게는 송출자가 보이도록 Remote View를 등록합니다.

<!-- Caster : local view -->
<video id="localVideo" autoplay muted></video>
<!-- Viewer : remote view -->
<video id="remoteVideo" autoplay></video>

보다 더 자세한 내용은 아래를 참고하세요.

Web - MediaAndroid - MediaiOS - Media

방송생성

RemonCastcreate() 함수를 이용하여 방송 만들 수 있습니다. create() 함수가 호출 되면 Remon의 미디어 서버에다른 사용자들이 접속 할 수 있는 방송이 채널로써 만들어 지게 됩니다. 이때 채널이 만들어 지면서 channelId를 반환하게 되고, 이를 통해 시청자가 접근할 수 있습니다.

// <video id="localVideo" autoplay muted></video>
let myChannelId

const config = {
  credential: {
    serviceId: 'MY_SERVICE_ID',
    key: 'MY_SERVICE_KEY'
  },
  view: {
    local: '#localVideo'
  },
  media: {
    sendonly: true
  }
}

const listener = {
  onCreate(channelId) {
    myChannelId = channelId
  }
}

const caster = new Remon({ listener, config })
caster.createCast()

방송시청

RemonCastjoinRoom(channelId) 함수를 이용하면 방송에 참여 할 수 있습니다. 이때 원하는 channelId를 알려줘야 하는데 보통 아래의 Channel을 참고하여 전체 목록을 통해 사용자가 선택하는 방식이 많이 사용됩니다.

// <video id="remoteVideo" autoplay></video>
let myChannelId

const config = {
  credential: {
    serviceId: 'MY_SERVICE_ID',
    key: 'MY_SERVICE_KEY'
  },
  view: {
    local: '#remoteVideo'
  },
  media: {
    recvonly: true
  }
}

const listener = {
  onJoin() {
    // Do something
  }
}

const viewer = new Remon({ listener, config })
viewer.joinCast('MY_CHANNEL_ID')                  // myChnnelId from caster

Callbacks

개발중 다양한 상태 추적을 돕기 위한 Callback을 제공 합니다.

  • 안드로이드 2.4.13, iOS 2.6.9 버전부터 콜백은 모두 UI Thread 에서 호출됩니다.

const listener = {
  onInit(token) {
    // UI 처리등 remon이 초기화 되었을 때 처리하여야 할 작업
  },

  onConnect(channelId) {
    // 통화 생성 후 대기 혹은 응답
  },

  onComplete() {
    // Caller, Callee간 통화 시작
  },

  onClose() {
    // 종료
  }
}

더 많은 내용은 아래를 참조 하세요.​

Callbacks

Channel 목록 조회

방송을 만들면 채널이 생성되고 고유한 channelId가 생성 됩니다. 이 channelId를 통해 시청자가 생성된 방송에 접근가능합니다. 이때 방송중인 전체 채널 목록을 아래와 같이 조회 가능합니다.

const remonCast = new Remon()
const casts = await remonCast.fetchCasts()

더 자세한 내용은 아래를 참고하세요.

Channel

종료

방송의 송출, 시청이 끝났을 경우 꼭 RemonCast객체를 close()해주어야 합니다. close를 통해서 모든 방송 자원과 미디어 스트림 자원이 해제됩니다.

const remonCast = new Remon()
remonCast.close()

기타

아래를 통해 보다 자세한 설정, 실 서비스를 위한 프렉티스등 다양한 내용을 확인해 보세요.

Config/RemonConfigNetwork Environment

Last updated