Login
      내용 x
      Android 환경
        • 인쇄
        • PDF
        내용

        Android 환경

          • 인쇄
          • PDF
          Article Summary

          Classic/VPC 환경에서 이용 가능합니다.

          Android 환경에서는 Android 전용 플레이어 개발을 위한 Video Player Enhancement Android SDK 사용 방법과 플레이어 적용 및 옵션 설정 방법을 설명합니다.

          참고

          Android용 Video Player Enhancement SDK를 사용하려면 Standard 요금제를 이용해야 하며, 다음과 같은 사양이 요구됩니다.

          • 최소 사양: API 26(Oreo 8.0) 이상, gradle 4.2.2 이상
          • 개발 환경: Android Studio

          SDK 설치 및 환경 구성

          SDK를 설치하고 프레임워크를 추가하는 방법은 다음과 같습니다.

          1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
          2. Services > Media > Video Player Enhancement 메뉴를 차례대로 클릭해 주십시오.
          3. Video Player Management 메뉴를 클릭해 주십시오.
          4. 플레이어 목록에서 SDK를 다운로드할 플레이어의 [SDK 주소] 버튼을 클릭해 주십시오.
          5. 모바일 네이티브 SDKs 다운로드의 [Android] 버튼을 클릭해 주십시오.
            • 압축 파일이 다운로드됩니다.
          6. 다운로드한 SDK 파일을 root > app > libs 경로에 추가해 주십시오.
          7. app 레벨 build.gradle 파일의 dependencies에 다음과 같이 추가해 주십시오.
            dependencies {
    ...
    implementation files('libs/NCPlayerSDK.aar')
    implementation 'com.google.code.gson:gson:2.10.1'
}

          플레이어 적용 및 설정

          플레이어를 적용하고 옵션을 설정하려면 다음 절차를 진행해 주십시오.

          1. 초기화

          다음과 같이 NCPlayerSDK 인스턴스를 초기화하고 Delegate를 설정해 주십시오.

          ...
import com.sgrsoft.ncp_aos.*
...
class MainActivity : AppCompatActivity() {
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        ...
        var delegate = PlayerDelegate()
        NCPlayer.delegate = delegate

    }
}

          2. 플레이어 설정

          플레이어를 설정하는 방법은 다음과 같습니다.

          1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
          2. Services > Media > Video Player Enhancement 메뉴를 차례대로 클릭해 주십시오.
          3. Video Player Management 메뉴를 클릭해 주십시오.
          4. 설정할 플레이어의 [SDK 주소] 버튼을 클릭해 주십시오.
          5. Player SDK 주소 팝업 창이 나타나면 SDK 주소에서 access_key 값을 확인해 주십시오.
            vpe-ios_key_ko
          6. Android Studio에서 NCPlayerView를 사용할 UIView를 생성해 주십시오.
          7. 플레이어의 옵션을 설정해 주십시오.
            • 플레이어 설정과 이 가이드의 플레이어 설정 스크립트를 참고해 주십시오.
            import com.sgrsoft.ncp_aos.*
...
class MainActivity : AppCompatActivity() {
    ...
    private lateinit var webView: WebView;
 
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        ...

        webView = findViewById(R.id.webVIew)
      
        // 등록된 APPLICATION_ID를 사용, 콘솔에 등록되어 있는 패키지 아이디만 허용됨
        var packageId = BuildConfig.APPLICATION_ID
     
        // licenseKey = access_key
        var licenseKey = "{access_key}" 
     
        // 화면 녹화 및 캡처 방지 기능 사용 여부(true: 기능 제한)
        var isScreenCaptureDeny = false
     
        // NCPlayerView 생성
        var player = NCPlayerView()
     
        // NCPlayerView 웹뷰와 연결
        player.webView = webView
     
        NCPlayer.prefs.setString("appId",packageId)
        NCPlayer.prefs.setString("licenseKey",licenseKey)
        NCPlayer.prefs.setString("isScreenCaptureDeny", isScreenCaptureDeny.toString())
     
        // 플레이어 옵션(콘솔에서 만들어진 스크립트 코드 사용)
        val playerOptions = 
        """
        {
            "playlist":[
                {
                    "file":"https://CDN도메인/example_video_01.mp4",
                    "poster":"https://CDN도메인/example_video_01.png",
                }
            ],
            "autostart":true,
        }
     
        """
        // 실행
        player.play(playerOptions,this)
    }
}
          8. 녹화 방지를 위해 다음과 같이 코드를 작성해 주십시오.
            import com.sgrsoft.ncp_aos.*
...
class MainActivity : AppCompatActivity() {
    ...
    
    private lateinit var webView: WebView;
    var player = NCPlayerView()
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        ...
        // 화면 녹화 및 캡처 방지 기능 사용 여부(true: 기능 제한)
        val isScreenCaptureDeny = false
        
        // NCPlayer에 변수 등록
        // "" 안의 string 값은 변경 금지
        NCPlayer.prefs.setString("isScreenCaptureDeny", isScreenCaptureDeny.toString())
    }
}
          9. Picture in Picture 기능 사용을 위해 다음과 같이 코드를 작성해 주십시오.
            override fun onUserLeaveHint() {
// 가로 비율을 원할 경우 <예시> 16,9
// 세로 비율을 원할 경우 <예시> 9,16
player.enterPip(this,9,16)
}
          10. 웹뷰를 사용하는 경우 메모리 누수(Memory Leak) 방지를 위해 다음과 같이 플레이어 해제 코드를 작성해 주십시오.
            import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
... 
    player.destroy()
}

          3. 이벤트 설정

          Player Event API를 통해 Video Player Enhancement 플레이어에서 발생하는 이벤트를 바인딩하여 활용할 수 있습니다. 방법은 다음과 같습니다.

          1. NCPlayerNetworkStatus 메소드를 이용하여 디바이스의 네트워크 상태를 확인해 주십시오.
            import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerNetworkStatus(state: String) {
        // state: ONLINE = 이상 없음 (ONLINE)
        // state: OFFLINE = 문제 발생 (OFFLINE 혹은 통신 장애 발생)
    }
}
          2. 설정하고자 하는 이벤트에 따라 설정 방법을 확인해 주십시오.

          가로 모드 활성화 이벤트

          디바이스를 가로로 전환 시 이벤트를 발생시키려면 NCPlayerIsLandscape 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerIsLandscape(state: Boolean) {
    
    }
}

          TimeUpdate 이벤트

          재생 시간 변화 감지 시 이벤트를 발생시키려면 NCPlayerOnTimeUpdate 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnTimeUpdate(data: JSONObject?) {
        // data = {"sourceType":"vod","currentTime":1,"duration":7715,"percent":0.008898181834278056,"viewingTime":1}
    }
}
          참고

          각 속성에 대한 자세한 설명은 timeupdate 스크립트를 참고해 주십시오.

          PrevTrack 이벤트

          플레이리스트 중 이전 영상으로 이동 시 이벤트를 발생시키려면 NCPlayerOnPrevTrack 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnPrevTrack(data: JSONObject?) {
        // {"file":"","poster":"","description":{"title":"title","created_at":"","profile_name":"string","profile_image":"string"}}
    }
}
          참고

          각 속성에 대한 자세한 설명은 prevTrack 스크립트를 참고해 주십시오.

          NextTrack 이벤트

          플레이리스트 중 다음 영상으로 이동 시 이벤트를 발생시키려면 NCPlayerOnNextTrack 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnNextTrack(data: JSONObject?) {
        // {"file":"","poster":"","description":{"title":"title","created_at":"","profile_name":"string","profile_image":"string"}}
    }
}
          참고

          각 속성에 대한 자세한 설명은 nextTrack 스크립트를 참고해 주십시오.

          컨트롤바 활성화 이벤트

          플레이어에서 컨트롤바 활성화/비활성화 시 이벤트를 발생시키려면 NCPlayerOnControlbarActive 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnControlbarActive(active: JSONObject?) {
        // active: true, false
    }
}

          재생 이벤트

          플레이어에서 영상 재생 시 이벤트를 발생시키려면 NCPlayerOnPlay 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnPlay() {
    
    }
}

          일시 정지 이벤트

          플레이어에서 영상 일시 정지 시 이벤트를 발생시키려면 NCPlayerOnPause 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnPause() {
    
    }
}

          재생 완료 이벤트

          플레이어에서 영상 재생 완료 시 이벤트를 발생시키려면 NCPlayerOnEnd 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    override fun NCPlayerOnEnd() {
    
    }
}

          전체 화면 이벤트

          전체 화면 전환 시 이벤트를 발생시킬 수 있으며, 디바이스 회전 시 전체 화면으로 자동 전환하도록 설정할 수 있습니다.

          전체 화면 이벤트

          플레이어를 전체 화면으로 전환 시 이벤트를 발생시키려면 NCPlayerOnFullscreen 메소드를 이용하여 다음과 같이 설정해 주십시오.

          import com.sgrsoft.ncp_aos.*
...
class PlayerDelegate: NCPlayerEventInterface{
    ...
    
    val delegate = PlayerDelegate()
    NCPlayer.delegate = delegate
    
    override fun NCPlayerOnFullscreenState(state: Boolean) {
        // fullscreen true / false
    }
    
    // 전체 화면이 꺼졌을 때 발생하는 이벤트
    override fun NCPlayerOnFullscreenOff() {
    
    }
    
    // 전체 화면이 되었을 때 발생하는 이벤트
    override fun NCPlayerOnFullscreenOn() {
    
    }
}

          전체 화면 자동 전환

          디바이스 회전 시 전체 화면으로 자동 전환하는 기능을 제공하려면 다음과 같이 설정해 주십시오.

          override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)

    if (newConfig.orientation == Configuration.ORIENTATION_PORTRAIT)
    {
        NCPlayer.delegate?.NCPlayerIsLandscape(false)
        player.fullscreenOff()
    }
    else if (newConfig.orientation == Configuration.ORIENTATION_LANDSCAPE)
    {
        NCPlayer.delegate?.NCPlayerIsLandscape(true)
        player.fullscreenOn()
    }
}
          이 문서가 도움이 되었습니까?
          What's Next
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          First name must have atleast 2 characters. Numbers and special characters are not allowed.
          Last name must have atleast 1 characters. Numbers and special characters are not allowed.
          Enter a valid email
          Enter a valid password
          Your profile has been successfully updated.
          Logout