dogeby/simpleplayer

SimplePlayer

기기 내 동영상을 재생 목록으로 모아 볼 수 있는 동영상 플레이어 앱

개발 기간

2022.04.24 ~ 2022.5.24

기술 스킬

분류	기술 스킬
Architecture	MVVM, ViewBinding
Async Task	Kotlin Coroutine, Flow
External Library	Exoplayer, Glide
Database	Room, Preferences Datastore
Language	Kotlin
Test	Junit4

프로젝트 환경

Min sdk: 26 (Android 8)
Target sdk: 31 (Android 12)

프로젝트 기능

폴더 리스트

        

• 폴더별 동영상 리스트를 출력한다.
• MediaStore로 디바이스 내 동영상을 불러온다.
• 폴더 통째로 재생 목록에 저장할 수 있다.

최근 동영상 리스트

• 최근 재생한 동영상을 보여준다.
• Room으로 최근 동영상 재생 날짜를 관리한다.
• 최근 동영상을 목록에서 삭제할 수 있다.

재생 목록 리스트

        

• 원하는 동영상들을 재생 목록에 추가해서 볼 수 있다.
• Room으로 재생 목록을 관리한다. 재생 목록과 동영상은 다대다 관계로 정의되어있다.
• 재생 목록의 동영상을 삭제할 수 있다. 재생 목록을 삭제하거나 이름을 변경할 수 있다.

검색

• 현재 리스트 아이템 중 글자를 입력할 때마다 검색어에 해당하는 결과를 보여준다.

동영상 재생

        

• 동영상을 재생한다.
  
• 되감기, 빨리 감기, 이전 동영상, 다음 동영상 기능이 있다.
• 동영상 width, height 비율에 따라 자동으로 orientation을 전환한다.
• 설정에서 플레이어 컨트롤러 테마를 터치방식으로 설정하면 더블탭 시 되감기 또는 빨리 감기를 한다.

PIP 모드

• Home Button 또는 OverviewButton을 터치하면 PIP모드로 들어간다.
• PIP 모드에서는 재생, 정지, 전체화면으로 전환, 종료 기능이 있다.
• PIP 모드에서 다른 동영상 클릭 시 클릭한 동영상 재생
  • 동영상을 재생하는 PlayerActivity의 launchMode를 singleTask로 설정

설정

        

• Datastore, Preference로 구현한 앱 설정 화면
• 플레이어 컨트롤러 테마를 변경할 수 있다.
• 최근 동영상 목록, 재생 목록을 초기화할 수 있다.
• 오픈소스 라이선스를 볼 수 있다.

주요 트러블 슈팅

낮은 빈도로 동영상 플레이어(PlayerActivity) 종료 시 UI 겹침 현상 발생

• 증상: 동영상 재생 화면에서 백 버튼 클릭 시 동영상 리스트 UI와 폴더 리스트 UI가 겹쳐서 나온다.
  한 번 더 백 버튼 클릭 시 두 폴더 리스트 UI가 겹쳐서 나온다.
  

• 원인: 동영상 재생 중 드물게 현재 PlayerActivity 이전 Activity인 ListActivity가 destroy 되고, VideoListFragment도 destroy 된다.
  ListActivity가 destroy 된 이유는 시스템이 ListActivity를 종료시킨 것으로 생각된다.
  PlayerActivity가 종료되면 destroy했던 ListActivity가 create 되면서 activity에 FolderListFragment를 추가하는 코드가 동작했기에 UI가 겹치는 문제가 발생한 것으로 생각된다.
  

• 조치: 만약 ListActivity가 recreat시 기본 Fragment(FolderListFragment)를 추가 안 하게 조치했다.

  private var isDefault = true
  override fun onCreate(savedInstanceState: Bundle?) {
      ...
      if (savedInstanceState != null) {
          isDefault = savedInstanceState.getBoolean(isDefaultKey)
      }
      ...
      initUi()
  }
  private fun initUi() {
      if(isDefault) {
          isDefault = false
          addDefaultListFragment()
      }
      ...
  }
  private fun addDefaultListFragment() {
      setAppbarTitleText(R.string.appbar_title_folder)
      supportFragmentManager.beginTransaction().add(binding.recyclerViewContainer.id, FolderListFragment()).commit()
  }
   override fun onSaveInstanceState(outState: Bundle) {
      super.onSaveInstanceState(outState)
      outState.putBoolean(isDefaultKey, isDefault)
  }

가끔씩 최근 동영상이나 재생목록, 재생목록의 동영상 삭제 할 때나 재생목록의 이름 수정 시 리스트가 업데이트 안 되는 문제

• 증상: 최근 동영상, 재생목록, 재생목록의 동영상 삭제 시 리스트에 삭제한 아이템이 사라져야지만 리스트에 남아있다.
  재생목록의 이름 수정 시 수정 전 이름 그대로이다.
  SwipeRefresh을 통해 업데이트 호출해야지 적용된 UI를 볼 수 있다.
  

• 원인: 삭제 또는 수정 함수 호출 후 리스트 업데이트 함수를 호출하는데 이 두 함수는 비동기로 작동하기 때문에 변경 전 데이터가 업데이트되는 경우가 있다.

• 조치: 리스트 업데이트 함수를 삭제하고, 리스트 업데이트를 Flow에 맡기기로 했다.

재생목록 리스트의 경우
PlaylistViewModel.kt

val playlistsWithVideoInfo = playlistRepository.getPlaylistsWithVideoInfo().asLiveData()

PlaylistRepository.kt

fun getPlaylistsWithVideoInfo() = playlistDbDao.getPlaylistsWithVideoInfo()

PlaylistDbDao.kt

@Transaction
@Query("SELECT * FROM Playlist")
fun getPlaylistsWithVideoInfo(): Flow<List<PlaylistWithVideoInfo>>