Skip to content

android-tv-support.md

Latest commit

 

History

History
55 lines (38 loc) · 2.52 KB

android-tv-support.md

File metadata and controls

55 lines (38 loc) · 2.52 KB
Raw

Android TV Support

This document details the Android TV compatibility and UI enhancements introduced in Nightzuku.

Overview

Nightzuku provides a first-class experience on Android TV devices, featuring a dedicated UI built with Material 3 Expressive components tailored for large screens and 10-foot interactions.

Material 3 Expressive UI for TV

The Android TV interface is not a scaled version of the phone UI. It is a native implementation using Jetpack Compose for TV:

  • Large-screen layout: Optimized for 16:9 aspect ratios.
  • Enhanced Typography: High-legibility fonts and sizes suitable for viewing from a distance.
  • TV-specific components: Uses androidx.tv.material3 components, including TV-optimized buttons, cards, and navigation surfaces.

Monet (Dynamic Color) Support

On devices running Android 12 (SDK 31) and higher, Nightzuku supports Monet (Dynamic Color):

  • The UI automatically extracts colors from the user's wallpaper or system theme.
  • This ensures visual consistency with the Android TV system UI and other modern TV applications.
  • Users can toggle Dynamic Color in the Settings menu.

Black Night Theme

Nightzuku includes a dedicated Black Night Theme optimized for OLED and high-contrast viewing:

  • Uses true black (#000000) backgrounds.
  • Reduces eye strain in dark environments.
  • Improves contrast for better legibility on various TV panel types.

Focus Management and D-pad Navigation

The UI is designed for remote control interaction:

  • Predictable Focus: Logical focus movement between elements using the D-pad.
  • Visual Focus Cues: Clear, high-contrast focus rings and scale animations on focused items.
  • Click Handling: All interactive elements are mapped to the D-pad "Select" or "OK" button.
  • Back Button: Standardized back navigation using the remote's back button.

TV-Optimized Dialogs

Dialogs in Settings and Modules have been redesigned for TV:

  • Center-aligned: Dialogs appear in the center of the screen for better visibility.
  • Focus Locking: Focus is trapped within the dialog until it is dismissed.
  • Scrollable Content: Long module descriptions or logs are easily scrollable using the D-pad.
  • Confirmation Actions: Clear "Confirm" and "Cancel" buttons with distinct focus states.

Package Identity

All TV features respect the Nightzuku package identity:

  • Package Name: kerneldroid.nightzuku
  • Shared User ID: kerneldroid.nightzuku.uid (if applicable)

Verification

The TV UI has been verified on:

  • Android TV 16 emulator*