Config

방송은 RemonCast 객체를 통해 이루어집니다. RemonCast 객체에 설정 정보를 지정할 수 있습니다. 설정 정보는 Config 객체로 생성하여, RemoCast 객체 생성 시 인자로 전달합니다. Config 객체를 방송/시청 view가 아닌 곳에서 생성하여 방송/시청 view로 전달할 수 있어 편리합니다.

RemonCast 객체 생성 시 Config를 전달하는 방법 외에도, RemonCast의 connnect() 메소드 호출 시 Config를 인자로 전달하는 방법도 있습니다. 이 방법을 이용하면 RemonCast 객체 생성 시 사용한 Config을 사용하지 않고 connect() 메소드에게 전달된 Config를 사용합니다.

플랫폼 별로 클래스명이 조금 다릅니다. Web, Android용은 Config, iOS용은 RemonConfig 클래스를 참고하십시오.

• https://remotemonster.github.io/web-sdk/docs/module-Config.html

• https://remotemonster.github.io/android-sdk/index.html?com/remotemonster/sdk/Config.html

• https://remotemonster.github.io/ios-sdk/Classes/RemonConfig.html

Basics

가장 기본적으로 화면이 보일 View와 Service Id, Key를 지정하는 것이 필요합니다.

View

영상이 표출될 View를 지정하는 설정으로 뷰가 지정되지 않으면 영상이 보이지 않습니다. (iOS의 경우 View는 RemonConfig 에서 제공하지 않으므로, RemonCall, RemonCast 객체에 직접 지정해야 합니다.)

Web

<video id="remoteVideo" autoplay controls></video>
<video id="localVideo" autoplay controls muted></video>
<script>
  const config = {
    view: {
      remote: '#remoteVideo', local: '#localVideo'
    }
  }
</script>

Android - Java

Config config = new com.remotemonster.sdk.Config();
config.setLocalView((SurfaceViewRenderer) findViewById(R.id.local_video_view));
config.setRemoteView((SurfaceViewRenderer) findViewById(R.id.remote_video_view));

Android - Kotlin

Config config = com.remotemonster.sdk.Config()
config.localView = ((SurfaceViewRenderer) findViewById(R.id.local_video_view))
config.remoteView = ((SurfaceViewRenderer) findViewById(R.id.remote_video_view))

iOS - Swift

let myRemoteView:UIView! = UIView()
let myLocalView:UIView! = UIView()
let remonCall = RemonCall()
remonCall.remoteView = myRemoteView
remonCall.localView = myLocalView

iOS - ObjC

UIView *myRemoteView = [UIView new];
UIView *myLocalView = [UIView new];
RemonCall *remonCall = [[RemonCall alloc] init];
remonCall.remoteView = myRemoteView
remonCall.localView = myLocalView

Service Id, Key

Service Id, Key를 지정 하는 단계로 필수 입니다.

Web

const config = {
  credential: {
    serviceId: 'myServiceId', key: 'myKey'
  }
}

Android - Java

Config config = new com.remotemonster.sdk.Config();
config.setServiceId("myServiceId");
config.setKey("myKey");

Android - Kotlin

var config = com.remotemoster.sdk.Config()
config.serviceId = "serviceId"
config.key = "serviceKey"

iOS - Swift

let remonCall = RemonCall()
remonCall.serviceId = "myServiceId"
remonCall.serviceKey = "myServiceKey"

iOS - ObjC

RemonCall *remonCall = [[RemonCall alloc] init];
remonCall.serviceId = @"myServiceId"
remonCall.serviceKey = @"myServiceKey"

Meta

사용자의 UID, 프로퍼티 등 서비스에 필요한 meta 데이터를 설정 할 수 있습니다. 안드로이드의 경우 HashMap 객체를 전달할 수 있으며, iOS 는 String 데이터만 지원합니다.

Web

N/A

Android - Java

HashMap<String, Object> meta = new HashMap<>();
meta.put("uid", "lucas1234");
Config config = new com.remotemonster.sdk.Config();
config.setMeta( meta );

Android - Kotlin

var meta = hashMapOf<String, Object>()
meta.put("uid", "myUid")
var config = com.remotemoster.sdk.Config()
config.meta = meta

iOS - Swift

let config:RemonConfig = RemonConfig()
config.userMeta = "string"

iOS - ObjC

RemonConfig *config = [RemonConfig new];
config.userMeta = @"string";

Media

음성과 영상에 대한 보다 다양한 옵션이 제공됩니다.

각 플렛폼별 추가적인 설정은 아래를 참고하세요.

Select Video, Audio

비디오를 키고 끔으로써 영상방송/통화 혹은 음성방송/통화 컨텐츠 서비스를 만들 수 있습니다.

Web

// Audio Only
const config = {
  media: {
    audio: true,
    video: false
  }
}
// Audio, Video
const config = {
  media: {
    audio: true,
    video: true
  }
}

Android - Java

// Audio Only
config.setVideoCall(false);
// Audio, Video
config.setVideoCall(true);

Android - Kotlin

// Audio Only
config.videoCall = false
// Audio, Video
config.videoCall = true

iOS - Swift

// Audio Only
remonCall.onlyAudio = true
// Audio, Video
remonCall.onlyAudio = false             //default fasle

iOS - ObjC

// Audio Only
remonCall.onlyAudio = YES;
// Audio, Video
remonCall.onlyAudio = NO;             //default fasle

Video Options

width와 height는 상대편에게 보낼 영상의 해상도를 결정하는 것입니다. 최대 640, 480의 해상도로 보낼 것을 설정하였지만 이것이 꼭 지켜지는 것은 아닙니다. WebRTC는 기본적으로 네트워크나 단말의 상태에 따라 해상도와 framerate등을 유연하게 변화시키면서 품질을 유지하고 있기 때문입니다. 해상도가 실제와 차이가 날 수는 있지만 ratio는 최대한 맞추기 위해 노력합니다.

Browser는 H.264와 VP8, VP9등의 영상 코덱을 지원하고 있습니다. RemoteMonster는 H.264를 기본 코덱으로 사용하고 있으며 변경이 필요하다면 이 설정으로 변경할 수 있습니다.

frameRate항목은 1초에 몇번의 프레임으로 인코딩할 지를 결정합니다. 일반적인 영상통화에서는 15정도도 적당합니다.

facingMode는 기기의 앞과 뒤에 카메라가 있을 때 어떤 쪽의 카메라를 사용할 것인지를 결정하는 것입니다. 현재 모바일 버전의 크롬 브라우저에서는 facingMode가 제대로 동작하지 않습니다.

Web

const config = {
  media: {
    video: {
      width: {max: '640', min: '640'},
      height: {max: '480', min: '480'},
      codec: 'H264',                 // 'VP9', 'VP8', 'H264'
      frameRate: {max:15, min:15},
      facingMode: 'user',             // 'user', 'environment'
      maxBandwidth: '3000'
    }
  }
}

Android - Java

config.setVideoWidth(640);
config.setVideoHeight(480);
config.setVideoCodec("VP8");  // 'VP9', 'VP8', 'H264'
config.setVideoFps(15);

Android - Kotlin

config.videoWidth = 640
config.videoHeight = 480
config.videoCodec = "VP8"  // 'VP9', 'VP8', 'H264'
config.videoFps = 15

iOS - Swift

let remonCall = RemonCall()
remonCall.videoWidth = 640
remonCall.videoHeight = 480
remonCall.videoFps = 24
remonCall.videoCodec = "H264"
remonCall.useFrontCamera = true       // default true, 만약 false 라면 후면 카메라를 사용합니다.
// 로컬 비디오 전송 준비가 완료 되면 자동으로 로컬 비디오 캡쳐를 시작 합니다.
// 만약 이 값을 false로 설정 한다면 onComplete() 호출 이후에 startLocalVideoCapture()를 호출 하여야 합니다.
remonCall.autoCaptureStart = true     // default true

iOS - ObjC

RemonCall *remonCall = [[RemonCall alloc] init];
​
remonCall.videoWidth = 640;
remonCall.videoHeight = 480;
remonCall.videoFps = 24;
remonCall.videoCodec = @"H264";
remonCall.useFrontCamera = YES;       // this is true by default, if this is false, use the rear camera.
// Start local video capture automatically when it is ready to transmit a local video.
// If you set this value to false, you must call startLocalVideoCapture() after the onComplete() call.
remonCall.autoCaptureStart = YES;     // default true

Music / Voice Mode

영상, 음성모드일때 음성의 작동방식을 설정 할 수 있습니다. Voice 모드는 노이즈를 억제하고 음성을 명확하게 전달하는데 초점이 맞추어져 있으며 통화에 적합합니다. Music모드는 모든 소리를 왜곡 없이 명확하게 전달하는데 중점이 있습니다. 기본값은 Voice 입니다.

Web

N/A

Android - Java

config.setAudioType( AudioType.VOICE );

Builder에서 AudioType은 AudioType.MUSIC, AudioType.VOICE 두가지가 있습니다.

RemonCall의 default AudioType은 VOICE이며, RemonCast의 default는 MUSIC입니다.

Android - Kotlin

config.audioType = AudioType.VOICE

Builder에서 AudioType은 AudioType.MUSIC, AudioType.VOICE 두가지가 있습니다.

RemonCall의 default AudioType은 VOICE이며, RemonCast의 default는 MUSIC입니다.

iOS - Swift

iOS는 동적으로 해당기능을 제공하지 않으며 다음과 같이 설정하여야 합니다.

RemonSettings.plist 파일을 프로젝트에 추가하고, AudioType 값을 원하는 모드로 변경해 주세요.

iOS - ObjC

iOS는 동적으로 해당기능을 제공하지 않으며 다음과 같이 설정하여야 합니다.

RemonSettings.plist 파일을 프로젝트에 추가하고, AudioType 값을 원하는 모드로 변경해 주세요.

Debug

SILENT, ERROR, WARN, INFO, DEBUG, VERBOSE를 설정할 수 있으며 뒤로 갈 수록 더 자세한 로그를 확인할 수 있습니다.

Web

const config = {
  dev:{
    logLevel: 'INFO'
  }
}

Android - Java

config.setLogLevel(Log.DEBUG);

Android - Kotlin

config.setLogLevel = Log.DEBUG

iOS - Swift

let remonCast = RemonCast()
remonCast.debugMode = true

iOS - ObjC

RemonCall *remonCall = [[RemonCall alloc] init];
remonCall.debugMode = YES;