📝 Amazon IVS Broadcast SDK: Android Guide 에서 더 자세한 내용을 확인하실 수 있습니다!

1 AWS IVS❓

IVS (Amazon Interactive Video Service)
AWS에서 제공하는 관리형 라이브 비디오 스트리밍 서비스이다.

웹이나 앱에 쉽게 통합할 수 있어 AWS 콘솔에서 채널을 생성하고, SDK를 이용해 구현만 해 준다면 간편하게 버튼 몇 개로 앱 - 앱 / 앱 - 웹 등 다양한 방법으로 스트리밍하고, 또 그 스트리밍을 시청할 수 있다.

2 ✅ IVS 사전 설정

2.1 AWS 계정 생성

AWS IVS 서비스를 사용하기 위해서는 우선 AWS 계정이 필요하다. 계정 생성은 결제 수단 정보를 입력하는 것 외에는 보편적인 회원가입 과정과 동일하여 그리 어렵지 않기도 하고, 서치하면 금방 나오기 때문에 생략하도록 하겠다.

2.2 IAM 권한 설정

여기서 IAM이란? 서버나, 스토리지 등의 AWS 리소스들을 통합하고 안정적으로 관리하기 위한 AWS의 서비스이다.

회원가입을 마치면 AWS ROOT 계정을 부여받으며, 우리가 IVS 채널을 생성하고 SDK를 사용하기 위해서는 IAM 사용자를 생성하고 IVS 채널 생성에 대한 권한을 사용자에게 제공한다는 내용의 정책을 추가해 주어야 한다.

무슨 소리인지... 하나도 모르겠다?
라고 하더라도 괜찮다.

AWS에서는 IVS 관련 IAM 권한 설정에 대한 가이드를 친절하게 제공하고 있다! 이 단계에서는 해당 가이드를 보며 차근차근 그대로 따라가기만 하면 되겠다.

2.3 IVS 채널 생성

IVS 서비스에서는 수집 서버와 스트림 키를 사용하여 라이브 스트리밍을 시작한다. IVS 채널은 이와 같은 라이브 스트리밍과 관련된 구성 정보들을 저장하는곳이라고 보면 된다.

그래서 어떻게 생성하냐?

이 또한 AWS의 가이드를 참고하자.

이건 내가 실제로 프로젝트에 사용하고 있는 IVS 채널이다. (일부 정보는 블라인드 처리)

채널을 성공적으로 생성하게 되면 이렇게 스트리밍에 사용되는 여러 구성 정보들이 저장되고, 라이브 스트림 탭을 통해 실시간으로 스트리밍되는 화면을 확인해 볼 수 있으며, 스트림 세션에서는 언제 얼마나 스트리밍을 진행했는지 확인할 수 있다.

IVS 가이드에도 설명되어 있지만, 채널을 생성할 때 옵션을 선택하면 스트리밍 라이브 영상을 녹화된 형태로 저장하여 보관할 수도 있다!

---

이제 정말로 글의 제목인 Android broadcast application 구현 준비가 끝났다!
코드를 함께 첨부하며 설명할 예정이고, AWS에서도 SDK 사용에 대한 가이드 및 demo app 코드를 제공하니 관련 내용이 궁금하다면 하이퍼링크를 통해 살펴보면 되겠다.

3 📹 APP 구현 (Android Studio)

사실 AWS에서 제공하는 android broadcast demo app 코드(kotlin)를 그대로 가져다 사용하여도 무방하다.

(필자는 코틀린이 익숙하지 않아 java로 구현하기 위해 그냥 가이드를 참고하면서 새로 구현하였다... 😹)

3.1 라이브러리 설치

모듈의 build.gradle 파일에 있는 dependencies 부분에 하단의 코드를 추가해 준다.

dependencies {
     implementation 'com.amazonaws:ivs-broadcast:1.4.0'
}

3.2 이벤트 리스너 생성

상태 업데이트나 스트리밍 디바이스 변경 알림, 오류 및 세션 오디오 정보를 수신 가능한 이벤트 리스너 코드이다. 메인 액티비티에서 실행할 예정이어서 MainActivity.java 파일 안에 하단의 코드를 추가해 주었다.

BroadcastSession.Listener broadcastListener = new BroadcastSession.Listener() {
	@Override
	public void onStateChanged(@NonNull BroadcastSession.State state) {
	Log.d(TAG, "State=" + state);
	}

	@Override
	public void onError(@NonNull BroadcastException exception) {
	Log.e(TAG, "Exception: " + exception);
	}
};

3.3 CAMERA / AUDIO 권한 요청

스트리밍을 시작하기 위해서는 어플리케이션에서 사용자에게 디바이스의 카메라 및 마이크에 액세스할 수 있는 권한을 요청해야 한다. 따라서 사용자에게 부여된 권한이 있는지 확인하고, 없다면 권한을 요청하는 코드를 동일하게 MainActivity.java 파일에 추가해 준다.

final String[] requiredPermissions = { Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO };
for (String permission : requiredPermissions) {
	if (ContextCompat.checkSelfPermission(MainActivity.this, permission) != PackageManager.PERMISSION_GRANTED) {
		ActivityCompat.requestPermissions(MainActivity.this, requiredPermissions, 0x100);
        break;
	}
}

3.4 Broadcast Session 생성

스트리밍을 위한 브로드캐스트 세션을 생성해 준다.
하단의 코드는 후면 카메라를 사용한 스트리밍을 원할 때 추가하면 되는 코드이다.

Context ctx = getApplicationContext();
BroadcastSession broadcastSession = new BroadcastSession(ctx, broadcastListener, Presets.Configuration.STANDARD_LANDSCAPE, Presets.Devices.BACK_CAMERA(ctx));

스트리밍에 핸드폰의 전면 카메라를 사용하고 싶다면 하단의 코드로 추가해 주면 된다!

Context ctx = getApplicationContext();
BroadcastSessionbroadcastSession = new BroadcastSession(ctx, broadcastListener, Presets.Configuration.STANDARD_PORTRAIT, Presets.Devices.FRONT_CAMERA(ctx));

3.5 화면 미리보기 표시

카메라를 딱 켰을 때 렌즈로 보이는 화면이 미리보기로 제공되는 것처럼 어떤 화면이 보여지는지 확인하기 위해 xml 파일에 LinearLayout으로 미리보기 레이아웃을 추가하고, MainActivity.java 파일에는 하단의 코드를 추가해 준다.

broadcastSession.awaitDeviceChanges(() -> {
    for(Device device: session.listAttachedDevices()) {
        if(device.getDescriptor().type == Device.Descriptor.DeviceType.CAMERA) {
            LinearLayout previewHolder = findViewById(R.id.previewHolder);
            ImagePreviewView preview = ((ImageDevice)device).getPreviewView();
            preview.setLayoutParams(new LinearLayout.LayoutParams(
                    LinearLayout.LayoutParams.MATCH_PARENT,
                    LinearLayout.LayoutParams.MATCH_PARENT));
            previewHolder.addView(preview);
        }
    }
});

LinearLayout previewHolder = findViewById(R.id.previewHolder);

해당 부분은 본인이 xml 파일의 LinearLayout에 추가해 준 id를 적으면 된다! 잊지 말도록 하자.

3.6 Broadcast 시작

간단하게 코드 한 줄로 스트리밍을 시작할 수 있다!
URL 부분에는 IVS 채널의 수집 서버, STREAMKEY 부분에는 IVS 채널의 스트림 키 정보를 받아와 입력하면 된다.

broadcastSession.start(IVS_RTMPS_URL, IVS_STREAMKEY);

방송 시작 버튼을 통해 버튼을 누름으로써 스트리밍이 시작되도록 하고 싶다면, 필자가 구현한 것처럼 OnClickListener() 함수를 통해 설정해 주면 되겠다. 추가로 버튼을 누르면 간단한 Toast message가 함께 출력되도록 하였다.

Button broadbutton = (Button)findViewById(R.id.startbroad);

broadbutton.setOnClickListener(new View.OnClickListener(){
	@Override
	public void onClick(View v) {
		broadcastSession.start("rtmps://3c90cab980bd.global-contribute.live-video.net:443/app/", "sk_ap-northeast-2_yFcoiZCkIOLg_vKCoVZPK8UBYWahI8dUXOVUmQlwASj");
		Toast.makeText(ctx,"촬영을 시작합니다", Toast.LENGTH_SHORT).show();
		Toast.makeText(ctx,"네트워크와 전원 연결을 유지해 주세요", Toast.LENGTH_SHORT).show();
	}
});

3.7 Broadcast 종료

이전 과정과 동일하다. 설명은 줄이도록 하겠다. 코드를 참고하자.

broadcastSession.stop();

마찬가지로 버튼을 통해 동작하도록 하고 싶다면

Button stopbutton = (Button)findViewById(R.id.stopbroad);

stopbutton.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		broadcastSession.stop();
		Toast.makeText(ctx,"촬영을 종료합니다", Toast.LENGTH_SHORT).show();
	}
});

3.8 Broadcast Session 해제

브로드캐스트 세션이 더 이상 사용되지 않는 경우, 라이브러리에서 사용하는 리소스를 해제해 주어야 한다. 하단의 코드를 MainActivity.java 파일에 추가해 주자.

@Override
protected void onDestroy() {
    super.onDestroy();
    previewHolder.removeAllViews();
    broadcastSession.release();
}

---

📱 구현 예시

Android Studio 내의 에뮬레이터를 사용하여 스트리밍을 시작하고, AWS IVS 서비스 콘솔 내의 내 채널에서 해당 스트리밍이 원활하게 진행됨을 확인할 수 있었다.

본 게시글에서의 설명은 여기까지이다.

위에서도 언급했지만, AWS에서도 공식적으로 SDK 사용에 대한 가이드 및 demo app 코드를 제공하니 관련 내용이 궁금하다면 하이퍼링크를 통해 살펴보면 되겠다.