목차
JavaScript 라이브러리 파일 추가, Config 만들기
동영상이 표시될 요소(video tag) 추가
준비사항
HTML 템플릿 받아서 풀어놓기
단순 통화 앱 HTML 템플릿 을 다운로드하여 풀어 놓습니다. index.html, style.css, complete.html 3개의 파일을 확인하십시오. 내용이 비어있는 index.html 을 수정하며 단순 통화 앱을 만들어봅니다. 수정 완료된 내용은 complete.html 파일에서 확인할 수 있습니다. index.html 파일의 내용은 아래와 같습니다.
index.html
Copy <!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>리모트몬스터 단순 통화 앱</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/css/bootstrap.min.css">
</head>
<body>
<footer>
<p>리모트몬스터 제공</p>
</footer>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.slim.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/js/bootstrap.min.js"></script>
</body>
</html>
RemoteMonster JavaScript 라이브러리 파일 추가, Config 만들기
리모트몬스터 라이브러리 remon.js 파일을 추가합니다. 웹 브라우저 호환성을 위해 adapter.js 파일도 추가합니다. config를 만듭니다.
index.html
Copy <!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>리모트몬스터 단순 통화 앱</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/css/bootstrap.min.css">
</head>
<body>
<footer>
<p>리모트몬스터 제공</p>
</footer>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.slim.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/js/bootstrap.min.js"></script>
<!-- adapter.js, remon.js 파일을 추가하고 config를 만듭니다. -->
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@remotemonster/sdk/remon.min.js"></script>
<script>
const config = {
credential: {
serviceId: '발급 받은 Service Id를 입력',
key: '발급 받은 Secret Key를 입력'
}
}
</script>
</body>
</html>
동영상이 표시될 엘리먼트(video tag) 추가, 레이아웃에 맞추기
video 요소 2개를 추가합니다. 하나는 내 영상을 표시하고, 다른 하나는 상대방의 영상을 표시하기 위해서입니다. local video 요소에 autoplay 속성이 있으면 통화채널에 들어갔을 때 내 영상이 자동으로 표시됩니다. remote video 요소에 autoplay 속성이 있으면 통화채널에 상대방이 들어왔을 때 상대방 영상이 자동으로 표시됩니다. config에 remote와 local 항목으로 이 video 요소들의 ID를 입력합니다. button 요소 2개를 추가합니다. "시작" 버튼은 통화채널에 들어가고, "종료" 버튼은 통화채널에서 나가는 데 씁니다. 통화채널의 ID를 표시할 영역을 추가합니다.
시작 버튼을 눌렀을 때 영상이 보이지 않으면 video 요소의 autoplay 속성을 확인하십시오. Safari에서 동영상이 표시되지 않으면 playsinline 속성을 추가합니다.
local video 요소에는 muted 속성을 추가합니다. muted 속성이 없으면 내 마이크로 들어간 소리가 내 스피커로 나와 하울링이 발생할 수 있습니다.
index.html
Copy <!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>리모트몬스터 단순 통화 앱</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/css/bootstrap.min.css">
</head>
<body>
<main>
상대방
<video id="remoteVideo" autoplay playsinline></video>
나
<video id="localVideo" muted autoplay playsinline></video>
<button id="startCall">시작</button>
<button id="stopCall">종료</button>
<div id="channelId"></div>
</main>
<footer>
<p>리모트몬스터 제공</p>
</footer>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.slim.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/js/bootstrap.min.js"></script>
<!-- adapter.js, remon.js 파일을 추가하고 config를 만듭니다. -->
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@remotemonster/sdk/remon.min.js"></script>
<script>
const config = {
credential: {
serviceId: '발급 받은 Service Id를 입력',
key: '발급 받은 Secret Key를 입력'
},
view: {
remote: '#remoteVideo',
local: '#localVideo'
}
}
</script>
</body>
</html>
아래와 같은 모습을 만들겁니다. 안 예쁘다고요? 문서 뒷부분에서 예쁘게 해보겠습니다.
채널에 들어가기, 채널ID 확인하기
채널ID를 명시하지 않으면 임의의 채널을 생성합니다. onCreate 콜백을 이용하여 채널ID를 확인합니다.
index.html
Copy <!DOCTYPE html>
<html lang="ko">
<head>
<title>리모트몬스터 단순 통화 앱</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/css/bootstrap.min.css">
</head>
<body>
<main>
상대방
<video id="remoteVideo" autoplay playsinline></video>
나
<video id="localVideo" muted autoplay playsinline></video>
<button id="startCall">시작</button>
<button id="stopCall">종료</button>
<div id="channelId"></div>
</main>
<footer>
<p>리모트몬스터 제공</p>
</footer>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.slim.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/js/bootstrap.min.js"></script>
<!-- "시작" 버튼을 클릭 했을 때 채널에 들어갑니다. connectCall 부분을 주목해주십시오. 채널에 들어가면 콜백을 이용해 채널ID를 화면에 표시합니다. onConnect 부분을 주목해주십시오. -->
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@remotemonster/sdk/remon.min.js"></script>
<script>
const config = {
credential: {
serviceId: '발급 받은 Service Id를 입력',
key: '발급 받은 Secret Key를 입력'
},
view: {
remote: '#remoteVideo',
local: '#localVideo'
}
};
const listener = {
onConnect(chid) {
$('#channelId').text(chid);
console.log(`onConnect: ${chid}`);
}
};
const remonCall = new Remon({
config: config,
listener: listener
});
$('#startCall').click(function() {
remonCall.connectCall('my-first-channel');
});
</script>
</body>
</html>
테스트 하기
위 index.html 파일을 웹에 게시합니다. 로컬에서 테스트 할 경우 http와 https 모두 가능합니다. 로컬이 아닐 경우 반드시 https 환경에서 테스트해야합니다.
웹 브라우저 창을 2개 엽니다. 두 창에서 각각 index.html 파일의 주소를 엽니다. 두 창에서 각각 "시작" 버튼을 클릭합니다. 두 개의 동영상이 표시됩니다.
정상적으로 두 동영상이 표시되지 않는다면, 웹 브라우저의 JavaScript 콘솔 창을 열어 오류 메시지를 확인합니다.
아주 조금 예쁘게 하기, 통화 상태 표시하기
video 요소의 크기를 조절하고 배치를 바꾸어 보기 좋게 합니다. 다운로드 한 파일 중 style.css 파일을 index.html 파일에 삽입합니다.
index.html style.css
Copy <!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>리모트몬스터 단순 통화 앱</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/css/bootstrap.min.css">
<!-- 다운로드한 파일 중 style.css 파일을 index.html 파일에 삽입합니다. -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<main>
<div class="container">
<div class="row">
<div id="you" class="col-12 col-sm-6 col-md-6">
<h2>상대방</h2>
<video id="remoteVideo" class="remoteVideo" autoplay playsinline></video>
</div>
<div id="me" class="col-12 col-sm-6 col-md-6">
<h2>나</h2>
<video id="localVideo" class="localVideo" muted autoplay playsinline></video>
</div>
</div>
<div class="row">
<div id="controlLeft" class="col-6 col-sm-6 col-md-6">
<button id="startCall">시작</button>
</div>
<div id="controlRight" class="col-6 col-sm-6 col-md-6">
<button id="stopCall">종료</button>
</div>
</div>
<div class="row">
<div class="col-12 col-sm-12 col-md-12">
<div id="channelId"></div>
<div id="channelState"></div>
</div>
</div>
</div>
</main>
<footer>
<p>리모트몬스터 제공</p>
</footer>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.slim.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.3.1/js/bootstrap.min.js"></script>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@remotemonster/sdk/remon.min.js"></script>
<script>
const config = {
credential: {
serviceId: '발급 받은 Service Id를 입력',
key: '발급 받은 Secret Key를 입력'
},
view: {
remote: '#remoteVideo',
local: '#localVideo'
}
};
const listener = {
onConnect(chid) {
$('#channelId').text(chid);
$('#channelState').text("대기 중");
console.log(`onConnect: ${chid}`);
}, onComplete() {
$('#channelState').text("통화 중");
console.log(`onComplete`);
}, onClose() {
$('#channelState').text("통화 종료");
console.log(`onClose`);
}
};
const remonCall = new Remon({
config: config,
listener: listener
});
$('#startCall').click(function () {
remonCall.connectCall('my-first-channel');
});
// "종료" 버튼을 클릭하면 통화채널에서 나갑니다.
$('#stopCall').click(function() {
remonCall.close();
});
</script>
</body>
</html>
Copy .container {
text-align : center ;
}
#controlLeft {
text-align : right ;
}
#controlRight {
text-align : left ;
}
.remoteVideo {
background : orange ;
width : 240 px ;
height : 180 px ;
}
.localVideo {
background : purple ;
width : 240 px ;
height : 180 px ;
}
footer {
margin-top : 16 px ;
text-align : center ;
}
그 외 주요 메소드들
RemonCall의 주요 인스턴스 메소드는 다음과 같습니다.
close() : RemonCall 객체가 소멸됩니다. 통화를 종료할 때 사용합니다. close 후에 새 통화를 시작하려면 RemonCall 객체를 새롭게 생성 해야 합니다.
showLocalVideo(): 통화 시작 전에 자신의 카메라 화면을 미리 보고 싶을 때 호출합니다.
pauseLocalVideo(true): 통화 중 자신의 카메라 화면을 중지하고 싶을 때 호출합니다.
switchCamera(): 카메라가 여러 개일 때 카메라를 순차적으로 스위칭해서 보여줍니다.
fetchCalls() : 통화채널을 조회할 때 호출합니다.
Callback에 대하여
onInit(): RemonCall 객체 생성이 정상적으로 처리됐을 때 호출됩니다. token이 인자로 전달됩니다.
onConnect(): 통화채널이 만들어졌을 때 호출됩니다. 생성된 채널ID가 인자로 전달됩니다.
onComplete() : 통화 상대방과 연결이 됐을 때 호출됩니다.
onClose(): 통화가 종료되었을 때 호출됩니다. CloseType이 인자로 전달됩니다.
onError(): 에러가 발생했을 때 호출됩니다. 오류 메시지가 인자로 전달됩니다.
onStat(): RemoteMonster가 통화품질 데이터를 5초마다 자동으로 생성합니다. 통화품질 데이터가 생성될 때 호출됩니다. 통화품질 데이터가 인자로 전달됩니다.
자세한 내용은 다음 문서를 참고합니다.
Callback과 Observer
단순 통화 앱을 만들며 RemoteMonster를 이용해 기능을 구현하는 방법을 알아보았습니다. Remon SDK의 내부를 알면 다양한 옵션을 선택할 수 있고, 원하는 것을 쉽게 구현할 수 있습니다.
Remon SDK의 내부