v2.x
Android
Common
Android - Media
Overview
영상, 음성 미디어의 표출과 사용에 대해 안내합니다.
공통적인 부분은 아래를 참고하세요.
View
레이아웃과 관련하여 2개의 클래스를 제공하고 있습니다. 가장 핵심이 되는, 영상을 출력하는 View인
SurfaceViewRender 와 SurfaceViewRender 를 효율적으로 RelativeLayout에서 배치하는데 도움을 주는 PercentFrameLayout으로 이루어져 있습니다. 이 중에서도 SurfaceViewRender가 가장 핵심이므로 먼저 살펴보겠습니다.SurfaceViewRender
Basic
Android layout 파일에서 다음과 같이 layout에 배치함으로써
SurfaceViewRender를 사용할 수 있습니다.1
<RelativeLayout
2
android:layout_width="match_parent"
3
android:layout_height="match_parent"
4
android:background="@android:color/darker_gray"
5
android:layout_alignParentBottom="false"
6
android:layout_weight="2">
7
<org.webrtc.SurfaceViewRenderer
8
android:id="@+id/remote_video_view"
9
android:layout_width="wrap_content"
10
android:layout_height="wrap_content" />
11
<org.webrtc.SurfaceViewRenderer
12
android:id="@+id/local_video_view"
13
android:layout_width="wrap_content"
14
android:layout_height="wrap_content" />
15
</RelativeLayout>
Copied!
그리고 특정 Activity에서 다음과 같이 이 View의 객체를 얻어옵니다.
1
SurfaceViewRender localRender =
2
(SurfaceViewRenderer) findViewById(R.id.local_video_view);
3
SurfaceViewRender remoteRender =
4
(SurfaceViewRenderer) findViewById(R.id.remote_video_view);
Copied!
이제 이 뷰를 사용할 기본 준비가 완료되었습니다.
Remon 클래스의 객체를 생성하고 생성할 때 Config객체에 이 두 쌍의 뷰를 설정하면 통신이 시작됨과 함께 이 뷰에 카메라나 원격의 영상 스트림이 출력됩니다.Advanced
몇가지 이
SurfaceViewRender의 메소드를 살펴보겠습니다.뷰간의 Z-Order를 설정할 수 있습니다. 즉 이 뷰를 다른 뷰보다 위 위치하도록 설정합니다. 겹치는 뷰가 있을 경우 다른 뷰는 false로 하고 해당 뷰만 true로 설정해야 합니다.
1
localRender.setZOrderMediaOverlay(true/false);
Copied!
해당 뷰의 영상을 거울효과를 주어서 좌우가 바뀌는 방식으로 보여줄 수 있습니다.
1
localRender.setMirror(false);
Copied!
layout에 어떻게 채울지를 결정합니다.
1
localRender.setScalingType(RendererCommon.ScalingType);
Copied!
PercentFrameLayout
안드로이드의 ConstraintLayout 과 같이 제공하려는 서비스에 맞게 레이아웃을 구성 합니다. 리모트몬스터 안드로이드 SDK에서는 영상관련 View의 배치를 쉽게 하기 위해
PercentFrameLayout을 제공합니다. PercentFrameLayout을 이용하면 영상 관련 View를 RelativeLayout안에서 자유롭게 배치하고 동적으로 움직일 수 있습니다. PercentFrameLayout은 layout내의 뷰들을 퍼센트 방식으로 배치합니다. 해당 레이아웃을 relativeLayout상에서 가로세로 100%채워서 배치 합니다.
1
layout.setPosition(0,0,100,100);
Copied!
해당 레이아웃을 relativeLayout을 4분면으로 나눠서 좌측 하단에 50%를 차지합니다.
1
layout.setPosition(0,50,50,50);
Copied!
Fill Policy
Video를 보여주는
SurfaceViewRenderer의 ScalingType을 통해 비디오소스가 보이는 방식을 지정 할 수 있습니다. 
Video Source
Fit
뷰의 크기에 맞게 비디오 프레임의 크기가 조정됩니다. 가로 세로 비율을 유지합니다. 검은 색 테두리가 표시 될 수 있습니다.
1
surfaceView.setScalingType(RendererCommon.ScalingType.SCALE_ASPECT_FIT);
Copied!
Fill
비디오 프레임이 뷰의 크기를 채우기 위해 크기가 조정됩니다.종횡비 유지. 비디오 프레임의 일부는 Clipping 됩니다.
1
surfaceView.setScalingType(RendererCommon.ScalingType.SCALE_ASPECT_FILL);
Copied!
Balanced
FIT와 FILL 간의 절충입니. 비디오 프레임은 다음과 같이 채울 것입니다. 적어도 가로 세로 비율을 유지하면서 뷰를 가능하게 합니다.
1
surfaceView.setScalingType(RendererCommon.ScalingType.SCALE_ASPECT_BALNANCED);
Copied!
Audio
RemonCall의 setSpeakerphone(boolean)을 이용하여, 스피커폰을 사용할지 Earpiece 모드를 사용할 지 설정 할 수 있습니다.
CallActivity.java
1
btnSpeakerPhoneOnOff.setOnClickListener(view -> {
2
if (remonCall != null) {
3
isSpeakerPhone = isSpeakerPhone ? (isSpeakerPhone = false) : (isSpeakerPhone = true);
4
remonCall.setSpeakerphoneOn(isSpeakerPhone);
5
}
6
});
Copied!
Background Policy
안드로이드는 특별한 설정이 없으면 백그라운드시 모든 미디어가 송출 및 수신이 됩니다. 만약 수신등에서 백그라운드로 진입시 음소거가 필요하다면, 시스템 이벤트등을 통해 별도 처리하면 됩니다.
상황
미디어
내용
송출 백그라운드
영상
수신측에서 영상/음성 정상 수
송출 백그라운드
음성
수신측에서 음성 정상 수신
수신 백그라운
영상
음성을 들을 수 있음
수신 백그라운드
음성
음성을 들을 수 있음
Last modified 2yr ago