simple_xml/kr.open.library.simple_ui.xml.permissions.api/PermissionRequester

PermissionRequester

Coordinates runtime, special, and role permission requests through one API.

런타임/특수/Role 권한 요청을 하나의 API로 조정합니다.

The requester itself can be created before a Fragment is attached, but actual permission execution requires a lifecycle-ready host.

요청기 자체는 Fragment attach 이전에도 생성할 수 있지만, 실제 권한 실행은 lifecycle 준비가 된 호스트에서만 가능합니다.

Parameters

host

Host adapter supplying Activity/Fragment capabilities.

Activity/Fragment 기능을 제공하는 호스트 어댑터입니다.

Constructors

PermissionRequester

@MainThread

constructor(activity: ComponentActivity)

Creates a requester bound to an Activity host.
Must be called on the main thread.

Activity 호스트에 바인딩된 요청기를 생성합니다.
메인 스레드에서만 호출해야 합니다.

@MainThread

constructor(fragment: Fragment)

Creates a requester bound to a Fragment host.
Must be called on the main thread.

Fragment 호스트에 바인딩된 요청기를 생성합니다.
메인 스레드에서만 호출해야 합니다.

Types

Companion

object Companion

Companion container for internal constants.

내부 상수를 보관하는 companion 컨테이너입니다.

Functions

consumeOrphanedDeniedResults

fun consumeOrphanedDeniedResults(): List<OrphanedDeniedRequestResult>

Returns and clears orphaned denied results after process restore.

프로세스 복원 후 orphaned 거부 결과를 반환하고 비웁니다.

requestPermission

@MainThread

fun requestPermission(permission: String, onDeniedResult: (List<PermissionDeniedItem>) -> Unit, onRationaleNeeded: (PermissionRationaleRequest) -> Unit? = null, onNavigateToSettings: (PermissionSettingsRequest) -> Unit? = null)

Requests a single permission and returns denied results via callback.
Must be called on the main thread.

단일 권한을 요청하고 거부 결과를 콜백으로 반환합니다.
메인 스레드에서만 호출해야 합니다.

requestPermissions

@MainThread

fun requestPermissions(permissions: List<String>, onDeniedResult: (List<PermissionDeniedItem>) -> Unit, onRationaleNeeded: (PermissionRationaleRequest) -> Unit? = null, onNavigateToSettings: (PermissionSettingsRequest) -> Unit? = null)

Requests multiple permissions and returns denied results via callback.
The rationale/settings callbacks may switch to asynchronous UI by calling defer(policy), and the default deferred policy is CANCEL_ON_STOP.
rationale/settings 콜백은 defer(policy)를 호출해 비동기 UI로 전환할 수 있으며, 기본 defer 정책은 CANCEL_ON_STOP입니다.
Must be called on the main thread.

여러 권한을 요청하고 거부 결과를 콜백으로 반환합니다.
메인 스레드에서만 호출해야 합니다.

restoreState

@MainThread

fun restoreState(savedInstanceState: Bundle?)

Restores internal state from savedInstanceState.
Must be called on the main thread.

savedInstanceState에서 내부 상태를 복원합니다.
메인 스레드에서만 호출해야 합니다.

saveState

@MainThread

fun saveState(outState: Bundle)

Saves internal state into outState.
Must be called on the main thread.

outState에 내부 상태를 저장합니다.
메인 스레드에서만 호출해야 합니다.