Glance는 Action
클래스를 통한 사용자 상호작용 처리를 간소화합니다. Glance의 Action
클래스는 사용자가 실행할 수 있는 작업을 정의하며 개발자는 이 작업에 응답하여 실행되는 작업을 지정할 수 있습니다. GlanceModifier.clickable
메서드를 사용하여 모든 구성요소에 Action
을 적용할 수 있습니다.
앱 위젯은 원격 프로세스에 있으므로 작업은 생성 시에 정의되고 원격 프로세스에서 실행됩니다. 네이티브 RemoteViews
에서는 PendingIntents
를 통해 실행됩니다.
이 페이지에서는 다음 작업이 설명되어 있습니다.
활동 실행
사용자 상호작용 시 활동을 실행하려면 GlanceModifier.clickable
(..) 수정자를 통해 actionStartActivity
함수를 Button
또는 다른 컴포저블에 제공합니다.
actionStartActivity
에 다음 중 하나를 제공합니다.
- 타겟 활동 클래스
ComponentName
- 인텐트
Glance는 제공된 타겟과 매개변수가 있는 PendingIntent
로 작업을 변환합니다. 다음 예에서는 사용자가 버튼을 클릭하면 NavigationActivity
가 실행됩니다.
@Composable fun MyContent() { // .. Button( text = "Go Home", onClick = actionStartActivity<MyActivity>() ) }
서비스 실행
활동 시작과 마찬가지로 actionStartService
메서드 중 하나를 사용하여 사용자 상호작용 시 서비스를 실행합니다.
actionStartService
에 다음 중 하나를 제공합니다.
- 타겟 활동 클래스
ComponentName
- 인텐트
@Composable fun MyButton() { // .. Button( text = "Sync", onClick = actionStartService<SyncService>( isForegroundService = true // define how the service is launched ) ) }
브로드캐스트 이벤트 전송
actionSendBroadcast
메서드 중 하나를 사용하여 사용자 상호작용 시 브로드캐스트 이벤트를 전송합니다.
actionSendBroadcast
에 다음 중 하나를 제공합니다.
- 문자열 작업
ComponentName
- 인텐트
BroadcastReceiver
클래스
@Composable fun MyButton() { // .. Button( text = "Send", onClick = actionSendBroadcast<MyReceiver>() ) }
맞춤 작업 실행
Glance는 특정 타겟을 실행하는 대신 람다 작업이나 actionRunCallback
를 사용하여 사용자 상호작용 시 UI 또는 상태를 업데이트하는 등의 작업을 실행할 수 있습니다.
람다 작업 실행
람다 함수를 UI 상호작용의 콜백으로 사용할 수 있습니다.
예를 들어 람다 함수를 GlanceModifier.clickable
수정자에 전달합니다.
Text( text = "Submit", modifier = GlanceModifier.clickable { submitData() } )
또는 이를 지원하는 컴포저블의 onClick
매개변수에 전달합니다.
Button( text = "Submit", onClick = { submitData() } )
ActionCallback 실행
또는 actionRunCallback
메서드를 사용하여 사용자 상호작용 시 작업을 실행합니다. 이렇게 하려면 ActionCallback
의 맞춤 구현을 제공합니다.
@Composable private fun MyContent() { // .. Image( provider = ImageProvider(R.drawable.ic_hourglass_animated), modifier = GlanceModifier.clickable( onClick = actionRunCallback<RefreshAction>() ), contentDescription = "Refresh" ) } class RefreshAction : ActionCallback { override suspend fun onAction( context: Context, glanceId: GlanceId, parameters: ActionParameters ) { // TODO implement } }
사용자 클릭 시 제공된 ActionCallback
의 suspend onAction
메서드가 호출되어 정의된 로직 (즉, 새로고침 데이터 요청)을 실행합니다.
작업을 실행한 후 위젯을 업데이트하려면 새 인스턴스를 만들고 update
(..)를 호출합니다. 자세한 내용은 GlanceAppWidget 상태 관리 섹션을 참고하세요.
class RefreshAction : ActionCallback { override suspend fun onAction( context: Context, glanceId: GlanceId, parameters: ActionParameters ) { // do some work but offset long-term tasks (e.g a Worker) MyAppWidget().update(context, glanceId) } }
작업에 매개변수 제공
작업에 추가 정보를 제공하려면 ActionParameters
API를 사용하여 유형이 지정된 키-값 쌍을 만듭니다. 예를 들어 클릭된 대상을 정의하는 방법은 다음과 같습니다.
private val destinationKey = ActionParameters.Key<String>( NavigationActivity.KEY_DESTINATION ) class MyAppWidget : GlanceAppWidget() { // .. @Composable private fun MyContent() { // .. Button( text = "Home", onClick = actionStartActivity<NavigationActivity>( actionParametersOf(destinationKey to "home") ) ) Button( text = "Work", onClick = actionStartActivity<NavigationActivity>( actionParametersOf(destinationKey to "work") ) ) } override suspend fun provideGlance(context: Context, id: GlanceId) { provideContent { MyContent() } } }
그 아래에는 활동을 실행하는 데 사용되는 인텐트에 매개변수가 포함되어 있으므로 타겟 활동에서 활동을 검색할 수 있습니다.
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val destination = intent.extras?.getString(KEY_DESTINATION) ?: return // ... } }
매개변수는 ActionCallback
에도 제공됩니다. 정의된 Parameters.Key
를 사용하여 값을 가져옵니다.
class RefreshAction : ActionCallback { private val destinationKey = ActionParameters.Key<String>( NavigationActivity.KEY_DESTINATION ) override suspend fun onAction( context: Context, glanceId: GlanceId, parameters: ActionParameters ) { val destination: String = parameters[destinationKey] ?: return // ... } }