다수의 참여자가 통화에 참여하는 서비스를 위한 기능입니다. 참여자는 앱을 이용하는 나와 그 외 참여자로 구분할 수 있습니다. 아래에서는 나와 참여자로 줄여서 표시합니다. 한 회기의 그룹통화는 RemonConference 클래스의 인스턴스로 대표됩니다. 나는 통화 연결, 참여자들의 입장/퇴장 알림 등 대부분의 일을 RemonConference 객체에게 위임합니다.
RemonConference
iOS SDK 2.7.0이상
그룹통화를 위해 RemonConference 객체를 생성하고, 설정을 진행합니다.
RemonConference 클래스는 그룹통화를 위해 아래 메소드를 제공합니다.
RemonConference 클래스는 콜백으로 사용하기 위해 아래 메소드를 제공합니다. 이하 콜백용 메소드라고 합니다. 콜백용 메소드는 위에서 언급한 메소드의 콜백으로만 호출하며, 일반적인 메소드처럼 호출하지 않습니다.
// create 메소드의 콜백용 메소드
.on( eventName:"onRoomCreate") { participant in
}.on( eventName:"onUserJoined") { participant in
}.on( eventName:"onUserStreamConnected") { participant in
}.on( eventName:"onUserLeft") { participant in
}.close {
}.error { error in
}
// participant 의 콜백용 메소드
.on(event:"onComplete") { participant in
}.on(event:"onClose") { participant in
}.on(evennt:"onError") { error in
}
레이아웃 작업
그룹통화 화면을 나의 영상 한 개와 그룹 참여자의 영상 여러 개로 구성합니다. 레이아웃에 영상을 표시할 view를 만들고 인덱스를 지정하여 참여자의 영상을 원하는 위치에 표시할 수 있도록 합니다.
레이아웃 초기화
레이아웃을 바인딩하고, 각 view를 배열에 담아 index 로 접근이 가능하도록 설정합니다.
@IBOutlet var viewArray: [UIView]!
var availableViews:[Bool]?
RemonConference 객체 생성
RemonConference 객체를 생성하고, 나의 영상을 송출하기 위한 설정을 합니다.
// 뷰를 설정하기 위한 배열 : 서버스에 맞게 구
availableViews = [Bool](repeating: false, count: self.viewArray.count)
var remonConference = RemonConference()
// config
let config = RemonConfig()
config.serviceId = "콘솔을 통해 발급 받은 Service Id"
config.key = "콘솔을 통해 발급 받은 Secret Key"
remonConference.create( "방이름", config: config) {
participant in
// 마스터유저가 전달됩니다. (iOS의 경우 Builder 를 제공하지 않습니다)
// 객체 생성은 RemonConference에서 이루어지므로 전달된 객체에 설정만을 제공합니다.
participant.localView( surfaceRendererArray[0] )
}.close {
// 마스터 유저가 종료된 경우 호출됩니다.
// 송출이 중단되면 그룹통화에서 끊어진 것이므로, 다른 유저와의 연결도 모두 끊어집니다.
}.error {
error in
// 마스터 유저가 연결된 채널에서 에러 발생 시 호출됩니다.
}
그룹통화 콜백
create 메소드로 그룹통화에 입장한 뒤 on() 메쏘드로 콜백을 등록할 수 있습니다.모든 참여자가 퇴장하면 이 이름의 그룹통화는 소멸됩니다.
새 참여자가 그룹통화에 입장하면 연결된 on 메소드의 콜백이 호출됩니다. on 메소드 콜백에서 RemonParticipant 객체가 제공되므로, 해당 정보를 사용해 설정을 진행합니다.
remonConference.create( "방이름", config: config) {
participant in
}.on( "onRoomCreated" ) {
participant in
// 마스터 유저가 접속된 이후에 호출(실제 송출 시작)
// TODO: 실제 유저 정보는 각 서비스에서 관리하므로, 서비스에서 채널과 실제 유저 매핑 작업 진행
// tag 객체에 holder 형태로 객체를 지정해 사용할 수 있습니다.
// 예제에서는 뷰 할당을 위해 단순히 view의 index를 저장합니다.
participant.tag = 0
// 뷰 설정용
availableViews?[0] = true
}.on( "onUserJoined" ) {
participant in
Log.d( TAG, "Joined new user" )
// 그룹통화에 새로운 참여자가 입장했을 때 호출됩니다.
// 새로운 참여자의 RemonParticipant 객체가 전달됩니다.
// 뷰 리스트에서 비어있는 뷰를 얻어와 설정합니다.
if let index = self?.getAvailableView() {
participant.localView = nil
participant.remoteView = self?.viewArray[index]
participant.tag = index
}
}.on( "onUserStreamConnected" ) {
participant in
}.on( "onUserLeft" ) {
participant in
// 다른 사용자가 퇴장한 경우
// participant.id 와 participant.tag 를 참조해 어떤 사용자가 퇴장했는지 확인후 퇴장 처리를 합니다.
if let index = participant.tag as? Int {
self?.availableViews?[index] = false
}
}
// 비어있는 뷰 검색 함수 : 각 서비스에 맞게 구성합니다.
func getAvailableView() ->Int {
if let views = self.availableViews {
for i in 0 ... views.count {
if views[i] == false {
self.availableViews?[i] = true
return i
}
}
}
return 0
}
그룹통화 종료
그룹통화에서 퇴장하면 나와 그룹통화의 연결이 종료됩니다. 나와 참여자들 간의 연결도 종료됩니다.
remonConference.leave()
RemonParticipant
각 참여자들과의 연결은 RemonConference 내부의 RemonParticipant 객체를 통해 이루어집니다. RemonParticipant 객체는 RemonClient를 상속받은 객체이므로, 공통적인 기능은 RemonCall, RemonCast 와 동일합니다. 각 이벤트마다 RemonParticipant 객체가 전달되므로 각 연결은 해당 객체를 통해 제어할 수 있으며, 마스터 객체의 경우 RemonConference 객체에서 얻어올 수 있습니다.
// 마스터 유저 얻기
var participant:RemonParticipant = remonConference.me
RemonParticipant 객체는 RemonClient를 상속받은 객체입니다. onCreate, onClose, onError 콜백은 on으로 재정의되어 RemonConference에서 관리, 사용되고 있으므로, 해당 콜백을 변경하지 마시기 바랍니다.
