설치 (Gradle)

VPEPlayer Android SDK는 AAR 로 배포되며 Gradle 로 설치합니다. 별도 인증 없이 raw GitHub Maven 저장소에서 받을 수 있습니다.

저장소 추가

settings.gradle.kts 의 dependencyResolutionManagement 에 Maven 저장소를 추가합니다.

settings.gradle.kts

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://raw.githubusercontent.com/SGRsoft-Dev/vpe2-android-native-sdk/master") }
    }
}

의존성 추가

앱 모듈의 build.gradle.kts 에 다음을 추가합니다.

app/build.gradle.kts

implementation("com.navercloud.vpe:player:2.0.2")

AndroidManifest 권장 설정

전체화면 가로 회전·PiP·미디어 알림을 위해 호스트 Activity 에 다음 설정을 권장합니다. SDK 매니페스트가 INTERNET / POST_NOTIFICATIONS / FOREGROUND_SERVICE* 권한을 병합 제공합니다.

AndroidManifest.xml

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|screenSize|smallestScreenSize|screenLayout|keyboardHidden"
    android:supportsPictureInPicture="true" />

전체화면 가로 전환이 유지되려면 호스트 Activity 에 최소 orientation|screenSize 의 configChanges 가 필수입니다.

import

설치 후 SDK 를 사용할 파일 최상단에서 import 합니다.

import com.navercloud.vpe.player.VpePlayer
import androidx.media3.common.util.UnstableApi

요구사항 — minSdk 24, Kotlin 2.0, Compose, JDK 17. Widevine 은 에뮬레이터에서 L3 로 제한될 수 있어 실기기(L1)를 권장합니다.