안드로이드 개발 팁 #41 - 액티비티에 전체 화면 적용 방법 (린백 옵션)

액티비티에 전체 화면 적용 방법 (린백 옵션)

---

시작하며…

마크다운 텍스트를 웹뷰로 보여주는 기능을 구현하고 있었는데요. 웹뷰 안에 위치한 유튜브 영상을 풀스크린으로 보는 기능도 구현해야 했습니다. 전체 화면 설정/해제하는 기능을 Activity 클래스의 확장 메소드로 정의해 보았습니다.

---

풀스크린 종류

안드로이드에서 적용 가능한 풀스크린은 3종류가 있습니다. 동영상을 전체화면으로 띄우는 경우에는 '린백'이 무난합니다. 관련 자세한 내용은 전체 화면 모드 사용 설정을 참고하세요.

• 린백(lean back)
• 이머시브 (immersive)
• 스티키 이머시브 (sticky immersive)

액티비티에 풀스크린 적용/해제 (린백)

안드로이드 버전에 따라 2가지 방법으로 나뉩니다.

• R (11) 미만
  • window 필드 객체의 decorView 필드의 setSystemUiVisibility(int visibility) 호출
  • 전체 모드 설정시 visibility: View.SYSTEM_UI_FLAG_FULLSCREEN, View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 비트를 on
  • 전체 모드 해제시 visibility: View.SYSTEM_UI_FLAG_FULLSCREEN, View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 비트를 off
• R (11) 이상
  • window 필드 객체의 getInsetsController() 메소드 호출
  • 리턴 받은 WindowInsetsController 객체의 show(int types), hide(int types) 메소드 호출
    • 전체 모드 설정시: hide(types) 호출
    • 전체 모드 해제시: show(types) 호출
    • types: WindowInsets.Type.statusBars() or WindowInsets.Type.navigationBars()

전체 화면 모드 적용 코드

fun Activity.setLeanBackFullscreen() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
        window?.decorView?.let {
            it.systemUiVisibility = it.systemUiVisibility
                .or(View.SYSTEM_UI_FLAG_FULLSCREEN)
                .or(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION)
        }
    }
    else {
        window?.insetsController?.let {
            it.hide(WindowInsets.Type.statusBars() or WindowInsets.Type.navigationBars())
        }
    }
}

전체 화면 해제 적용 코드

fun Activity.unsetFullscreen() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
        window?.decorView?.let {
            it.systemUiVisibility = it.systemUiVisibility
                .and(View.SYSTEM_UI_FLAG_FULLSCREEN.inv())
                .and(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION.inv())
        }
    }
    else {
        window?.insetsController?.let {
            it.show(WindowInsets.Type.statusBars() or WindowInsets.Type.navigationBars())
        }
    }
}

---

참고 링크

• 전체 화면 모드 사용 설정
• Window 클래스
• WindowInsetsController 클래스

---

지난 안드로이드 개발 팁

• #40 - 웹뷰에서 구글 로그인 우회 방법
• #39 - 스크린 항상 키는 방법
• #38 - 핸들러를 코루틴으로 대체하기
• #37 - 내비게이션 활용하여 프래그먼트간 이동
• #36 - DB Browser for SQLite에서 쿼리 실행 방법
• #35 - DB Browser for SQLite 사용법
• #34 - SQLite 데이터베이스 도구 DB Browser for SQLite 다운로드
• #33 - adb 명령어 사용을 위한 PATH 환경 변수 설정
• #32 - 코틀린 언어로 구현한 확장 함수를 자바 코드에서 호출하는 방법
• #31 - UTC 시간을 지역 시간으로 변환하는 함수
• #30 - Collection, MutableCollection 연산 확장 함수 filter, count, indexOfFirst, sortWith, sortedWith
• #29 - 프로젝트에 벡터 이미지 추가하기
• #28 - JSON 자료를 데이터 클래스로 자동 변환하는 방법
• #27 - 페이스북 로그인이 안 되는 문제
• #26 - 레이아웃 XML 파일에 이모지 문자 넣는 방법
• #25 - TED permission 라이브러리를 활용한 권한 요청
• #24 - EditText 뷰에 텍스트 입력하고 0.5초 후 액션 설정
• #23 - Uri 객체로부터 읽은 파라메터에서 '+' 문자가 ' '로 바뀌어 있는 문제
• #22 - RxJava 활용하여 몇초 후 코드 실행
• #21 - 맥북 아이클라우드로 프로젝트 복사 후 빌드 안 되는 문제
• #20 - 툴바 정의 방법 (1) 타이틀 및 배경색 설정
• #19 - Index corrupted 오류
• #18 - 오래된 프로젝트의 build.gradle 파일 수정
• #17 - 뷰 바인딩 적용된 프래그먼트에 데이터 바인딩 적용 후 빌드시 발생하는 오류
• #16 - 특정 일이 속하는 주의 모든 날짜를 배열로 구하는 방법
• #15 - RecyclerView에 리스트를 로딩한 후 처리할 일 작성
• #14 - RecyclerView 뷰에서 항목 클릭시 뷰가 깜빡이는 문제
• #13 - 공통으로 사용할 색상 리소스 만들고 뷰에 적용
• #12 - 코틀린 언어 변환시 추가로 수정할 build.gradle 파일들
• #11 - 리스트/배열로부터 찾을 원소의 위치 읽기
• #10 - 앱의 다크 모드 진입 막는 방법
• #9 - 데이터 바인딩/뷰 바인딩 사용하지 않을 경우 자체적으로 만드는 Views 클래스
• #8 - TextView에 linear gradient color 적용하기
• #7 - 다이얼 화면 연결하기 위해 Activity 클래스의 확장 메소드 작성
• #6 - 웹 브라우저를 여는 확장 메소드 작성
• #5 - HTML 적용된 TextView에서 링크 클릭은 어떻게 구현?
• #4 - RxJava의 Observable, Single 객체의 기본 설정 수행 메소드 정의하기
• #3 - 특정 화면 이동시 다른 화면 모두 닫기
• #2 - HTML 이스케이핑 적용된 문자 풀어주기
• #1 - TextView로 HTML 내용 보여주기

---