Android 11 이상에서 빠른 액세스 기기 제어 기능 사용자가 조명, 카메라, 오디오, 동영상 등 외부 기기를 사용자 어포던스로부터 카메라, 온도 조절기, 온도 조절기, 기본 런처입니다. 기기 OEM은 사용하는 런처를 선택합니다. 기기 서드 파티 공급업체 앱인 애그리게이터(예: Google Home)와 이 공간에 디스플레이용 기기를 제공합니다. 이 페이지에서는 제어 앱에 연결합니다.
<ph type="x-smartling-placeholder">이 지원을 추가하려면 ControlsProviderService
를 만들고 선언합니다. 만들기
사전 정의된 컨트롤 유형에 따라 앱에서 지원하는 컨트롤을 만든 다음,
관리할 수 있습니다.
사용자 인터페이스
기기는 기기 제어 아래에 템플릿 위젯으로 표시됩니다. 5개 다음 그림과 같이 기기 제어 위젯을 사용할 수 있습니다.
![]() |
![]() |
<ph type="x-smartling-placeholder">![]() |
![]() |
![]() |
터치 및 위젯을 들고 있으면 더 자세히 제어할 수 있는 앱으로 이동합니다. 다음과 같은 작업을 할 수 있습니다. 각 위젯의 아이콘과 색상을 맞춤설정할 수 있지만, 기본 설정이 기기와 일치하면 기본 아이콘과 색상을 사용합니다.
![온도 패널 위젯을 보여주는 이미지 (열림)](https://developer.android.com/static/images/device-control/device-control-panel2.png?hl=ko)
서비스 만들기
이 섹션에서는
ControlsProviderService
이 서비스는 Android 시스템 UI에 앱에 기기 제어가 포함되어 있음을 알립니다.
Android UI의 기기 제어 영역에 표시되어야 합니다.
ControlsProviderService
API는 다음과 같이 반응형 스트림에 익숙하다고 가정합니다.
Reactive Streams GitHub
프로젝트
Java 9 Flow에 구현되어 있으며
인터페이스를 참고하세요.
이 API는 다음 개념을 중심으로 빌드됩니다.
- 게시자: 사용자의 애플리케이션이 게시자입니다.
- 구독자: 시스템 UI가 구독자이며 번호를 요청할 수 있습니다. 제어할 수 없습니다.
- 구독: 게시자가 업데이트를 보낼 수 있는 기간입니다. 시스템 UI로 전달됩니다. 게시자 또는 구독자가 이 메서드를 닫을 수 있습니다. 창
서비스 선언
앱은 서비스(예: MyCustomControlService
)를 다음 위치에 선언해야 함
앱 매니페스트를 참조하세요.
서비스에는 ControlsProviderService
의 인텐트 필터가 포함되어야 합니다. 이
필터를 사용하면 애플리케이션이 시스템 UI에 컨트롤을 제공할 수 있습니다.
시스템 UI의 컨트롤에 표시되는 label
도 필요합니다.
다음 예는 서비스를 선언하는 방법을 보여줍니다.
<service
android:name="MyCustomControlService"
android:label="My Custom Controls"
android:permission="android.permission.BIND_CONTROLS"
android:exported="true"
>
<intent-filter>
<action android:name="android.service.controls.ControlsProviderService" />
</intent-filter>
</service>
그런 다음 MyCustomControlService.kt
라는 새 Kotlin 파일을 만들고 만듭니다.
다음과 같이 ControlsProviderService()
를 확장합니다.
Kotlin
class MyCustomControlService : ControlsProviderService() { ... }
자바
public class MyCustomJavaControlService extends ControlsProviderService { ... }
올바른 컨트롤 유형 선택
이 API는 컨트롤을 만드는 빌더 메서드를 제공합니다. 이 제어하려는 기기와 사용자의 상호작용 방식을 결정합니다. 사용할 수 있습니다. 다음 단계를 따르세요.
- 컨트롤이 나타내는 기기 유형을 선택합니다. 이
DeviceTypes
클래스는 지원되는 모든 기기가 열거됩니다. 유형은 UI에서 기기의 아이콘 및 색상을 설정합니다. - 사용자에게 표시되는 이름, 기기 위치(예: 키친, 그리고 컨트롤과 관련된 기타 UI 텍스트 요소입니다.
- 사용자 상호작용을 지원하는 최적의 템플릿을 선택합니다. 컨트롤에는 애플리케이션의
ControlTemplate
이 할당됩니다. 이 템플릿은 컨트롤 상태를 사용할 수 있는 입력 방법(즉,ControlAction
다음 표에는 사용 가능한 일부 템플릿과 작업이 요약되어 있습니다. 지원합니다.
템플릿 | 작업 | 설명 |
ControlTemplate.getNoTemplateObject()
|
None
|
애플리케이션은 이를 사용하여 컨트롤에 대한 정보를 전달할 수 있습니다. 상호작용할 수 없습니다. |
ToggleTemplate
|
BooleanAction
|
사용 설정 및 사용 중지 상태 간에 전환할 수 있는 컨트롤을 나타냅니다. BooleanAction 객체에는 변경되는 필드가 포함되어 있습니다.
- 사용자가 컨트롤을 탭할 때 요청된 새 상태를 나타냅니다.
|
RangeTemplate
|
FloatAction
|
지정된 최솟값, 최댓값, 단계 값이 있는 슬라이더 위젯을 나타냅니다. 날짜
사용자가 슬라이더와 상호작용하면 새 FloatAction 를 전송합니다.
객체를 다시 애플리케이션에 반환합니다.
|
ToggleRangeTemplate
|
BooleanAction, FloatAction
|
이 템플릿은 ToggleTemplate 과 RangeTemplate 의 조합으로, 슬라이더는 물론 터치 이벤트까지 지원합니다.
어둡게 할 수 있는 조명을 제어하는 등 말이죠.
|
TemperatureControlTemplate
|
ModeAction, BooleanAction, FloatAction
|
위의 작업을 캡슐화하는 것 외에도 이 템플릿을 사용하면 사용자가 난방, 냉방, 난방/냉방, 절전 또는 꺼짐과 같은 모드를 설정한 경우 |
StatelessTemplate
|
CommandAction
|
터치 기능을 제공하지만 그 상태가 있는 컨트롤을 나타내는 데 사용됩니다. 결정할 수 없습니다(예: IR 텔레비전 리모컨). 이 템플릿을 사용하여 컨트롤 및 상태 변경의 집계인 루틴 또는 매크로를 정의할 수 있습니다. |
이 정보를 사용하여 다음과 같이 컨트롤을 만들 수 있습니다.
- 컨트롤의 상태를 알 수 없는 경우
Control.StatelessBuilder
빌더 클래스를 사용합니다. - 컨트롤의 상태가 알려진 경우
Control.StatefulBuilder
빌더 클래스를 사용합니다.
예를 들어 스마트 조명 전구와 온도 조절기를 제어하려면 다음을 추가합니다.
상수를 MyCustomControlService
에 추가합니다.
Kotlin
private const val LIGHT_ID = 1234 private const val LIGHT_TITLE = "My fancy light" private const val LIGHT_TYPE = DeviceTypes.TYPE_LIGHT private const val THERMOSTAT_ID = 5678 private const val THERMOSTAT_TITLE = "My fancy thermostat" private const val THERMOSTAT_TYPE = DeviceTypes.TYPE_THERMOSTAT class MyCustomControlService : ControlsProviderService() { ... }
자바
public class MyCustomJavaControlService extends ControlsProviderService { private final int LIGHT_ID = 1337; private final String LIGHT_TITLE = "My fancy light"; private final int LIGHT_TYPE = DeviceTypes.TYPE_LIGHT; private final int THERMOSTAT_ID = 1338; private final String THERMOSTAT_TITLE = "My fancy thermostat"; private final int THERMOSTAT_TYPE = DeviceTypes.TYPE_THERMOSTAT; ... }
컨트롤의 게시자 만들기
컨트롤을 만든 후에는 게시자가 필요합니다. 게시자는 시스템 UI에 컨트롤의 존재를 알립니다. ControlsProviderService
클래스에는 애플리케이션 코드에서 재정의해야 하는 두 가지 게시자 메서드가 있습니다.
createPublisherForAllAvailable()
:Publisher
할 수 있습니다.Control.StatelessBuilder()
사용 이 게시자의Control
객체를 빌드합니다.createPublisherFor()
: 지정된 컨트롤 목록의Publisher
를 만듭니다. 문자열 식별자로 식별할 수 있습니다Control.StatefulBuilder
사용 용도 이Control
객체를 빌드하는 이유는 다음과 같습니다. 있습니다.
게시자 만들기
앱이 시스템 UI에 컨트롤을 처음 게시할 때 앱은 이를 알지 못합니다.
확인할 수 있습니다 상태 가져오기는 시간이 오래 걸리는 작업일 수 있음
장치-제공자의 네트워크에서 많은 홉을 포함합니다. createPublisherForAllAvailable()
메서드를 사용하여 사용 가능한 컨트롤을 시스템에 알립니다. 이 방법에서는
Control.StatelessBuilder
빌더 클래스. 각 컨트롤의 상태가
알 수 없습니다.
컨트롤이 Android UI에 표시되면 사용자는 즐겨찾기를 선택할 수 있습니다. 컨트롤을 탭합니다.
Kotlin 코루틴을 사용하여 ControlsProviderService
를 만들려면 새 코루틴을 추가합니다.
build.gradle
:
Groovy
dependencies { implementation "org.jetbrains.kotlinx:kotlinx-coroutines-jdk9:1.6.4" }
Kotlin
dependencies { implementation("org.jetbrains.kotlinx:kotlinx-coroutines-jdk9:1.6.4") }
Gradle 파일을 동기화하고 나면 Service
에 다음 스니펫을 추가하여
다음과 같이 createPublisherForAllAvailable()
를 구현합니다.
Kotlin
class MyCustomControlService : ControlsProviderService() { override fun createPublisherForAllAvailable(): Flow.Publisher= flowPublish { send(createStatelessControl(LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE)) send(createStatelessControl(THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE)) } private fun createStatelessControl(id: Int, title: String, type: Int): Control { val intent = Intent(this, MainActivity::class.java) .putExtra(EXTRA_MESSAGE, title) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE ) return Control.StatelessBuilder(id.toString(), action) .setTitle(title) .setDeviceType(type) .build() } override fun createPublisherFor(controlIds: List ): Flow.Publisher { TODO() } override fun performControlAction( controlId: String, action: ControlAction, consumer: Consumer ) { TODO() } }
자바
public class MyCustomJavaControlService extends ControlsProviderService { private final int LIGHT_ID = 1337; private final String LIGHT_TITLE = "My fancy light"; private final int LIGHT_TYPE = DeviceTypes.TYPE_LIGHT; private final int THERMOSTAT_ID = 1338; private final String THERMOSTAT_TITLE = "My fancy thermostat"; private final int THERMOSTAT_TYPE = DeviceTypes.TYPE_THERMOSTAT; private boolean toggleState = false; private float rangeState = 18f; private final Map> controlFlows = new HashMap<>(); @NonNull @Override public Flow.Publisher createPublisherForAllAvailable() { List controls = new ArrayList<>(); controls.add(createStatelessControl(LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE)); controls.add(createStatelessControl(THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE)); return FlowAdapters.toFlowPublisher(Flowable.fromIterable(controls)); } @NonNull @Override public Flow.Publisher createPublisherFor(@NonNull List controlIds) { ReplayProcessor updatePublisher = ReplayProcessor.create(); controlIds.forEach(control -> { controlFlows.put(control, updatePublisher); updatePublisher.onNext(createLight()); updatePublisher.onNext(createThermostat()); }); return FlowAdapters.toFlowPublisher(updatePublisher); } }
시스템 메뉴를 아래로 스와이프하여 화면에 표시된 기기 제어 버튼을 찾습니다. 그림 4:
![기기 컨트롤용 시스템 UI를 보여주는 이미지](https://developer.android.com/static/images/ui/device_controls_ui.png?hl=ko)
기기 제어를 탭하면 두 번째 화면으로 이동하여 원하는 기기를 선택할 수 있습니다. 있습니다. 앱을 선택하면 이전 스니펫에서 그림 5와 같이 새 컨트롤이 표시된 맞춤 시스템 메뉴:
![조명 및 온도 조절기 컨트롤이 포함된 시스템 메뉴를 보여주는 이미지](https://developer.android.com/static/images/ui/device_controls_example_1.png?hl=ko)
이제 createPublisherFor()
메서드를 구현하여 다음을 추가합니다.
Service
:
Kotlin
private val job = SupervisorJob() private val scope = CoroutineScope(Dispatchers.IO + job) private val controlFlows = mutableMapOf>() private var toggleState = false private var rangeState = 18f override fun createPublisherFor(controlIds: List ): Flow.Publisher { val flow = MutableSharedFlow (replay = 2, extraBufferCapacity = 2) controlIds.forEach { controlFlows[it] = flow } scope.launch { delay(1000) // Retrieving the toggle state. flow.tryEmit(createLight()) delay(1000) // Retrieving the range state. flow.tryEmit(createThermostat()) } return flow.asPublisher() } private fun createLight() = createStatefulControl( LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE, toggleState, ToggleTemplate( LIGHT_ID.toString(), ControlButton( toggleState, toggleState.toString().uppercase(Locale.getDefault()) ) ) ) private fun createThermostat() = createStatefulControl( THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE, rangeState, RangeTemplate( THERMOSTAT_ID.toString(), 15f, 25f, rangeState, 0.1f, "%1.1f" ) ) private fun createStatefulControl(id: Int, title: String, type: Int, state: T, template: ControlTemplate): Control { val intent = Intent(this, MainActivity::class.java) .putExtra(EXTRA_MESSAGE, "$title $state") .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE ) return Control.StatefulBuilder(id.toString(), action) .setTitle(title) .setDeviceType(type) .setStatus(Control.STATUS_OK) .setControlTemplate(template) .build() } override fun onDestroy() { super.onDestroy() job.cancel() }
자바
@NonNull @Override public Flow.PublishercreatePublisherFor(@NonNull List controlIds) { ReplayProcessor updatePublisher = ReplayProcessor.create(); controlIds.forEach(control -> { controlFlows.put(control, updatePublisher); updatePublisher.onNext(createLight()); updatePublisher.onNext(createThermostat()); }); return FlowAdapters.toFlowPublisher(updatePublisher); } private Control createStatelessControl(int id, String title, int type) { Intent intent = new Intent(this, MainActivity.class) .putExtra(EXTRA_MESSAGE, title) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); PendingIntent action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE ); return new Control.StatelessBuilder(id + "", action) .setTitle(title) .setDeviceType(type) .build(); } private Control createLight() { return createStatefulControl( LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE, toggleState, new ToggleTemplate( LIGHT_ID + "", new ControlButton( toggleState, String.valueOf(toggleState).toUpperCase(Locale.getDefault()) ) ) ); } private Control createThermostat() { return createStatefulControl( THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE, rangeState, new RangeTemplate( THERMOSTAT_ID + "", 15f, 25f, rangeState, 0.1f, "%1.1f" ) ); } private Control createStatefulControl(int id, String title, int type, T state, ControlTemplate template) { Intent intent = new Intent(this, MainActivity.class) .putExtra(EXTRA_MESSAGE, "$title $state") .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); PendingIntent action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE ); return new Control.StatefulBuilder(id + "", action) .setTitle(title) .setDeviceType(type) .setStatus(Control.STATUS_OK) .setControlTemplate(template) .build(); }
이 예에서 createPublisherFor()
메서드에는 모조
기기와 통신하여
상태를 가져와 시스템에 내보냅니다.
createPublisherFor()
메서드는 Kotlin 코루틴과 흐름을 사용하여 다음을 충족합니다.
필요한 Reactive Streams API를 다음과 같이 수정합니다.
Flow
를 만듭니다.- 1초 동안 대기합니다.
- 스마트 조명 상태를 생성하고 방출합니다.
- 다시 1초 동안 기다립니다.
- 온도 조절기의 상태를 생성하고 내보냅니다.
작업 처리
performControlAction()
메서드는 사용자가
있습니다. 전송된 ControlAction
유형에 따라 작업이 결정됩니다.
지정된 컨트롤에 적절한 작업을 실행한 후 상태를 업데이트합니다.
Android UI에서 확인할 수 있습니다.
예시를 완료하려면 Service
에 다음을 추가합니다.
Kotlin
override fun performControlAction( controlId: String, action: ControlAction, consumer: Consumer) { controlFlows[controlId]?.let { flow -> when (controlId) { LIGHT_ID.toString() -> { consumer.accept(ControlAction.RESPONSE_OK) if (action is BooleanAction) toggleState = action.newState flow.tryEmit(createLight()) } THERMOSTAT_ID.toString() -> { consumer.accept(ControlAction.RESPONSE_OK) if (action is FloatAction) rangeState = action.newValue flow.tryEmit(createThermostat()) } else -> consumer.accept(ControlAction.RESPONSE_FAIL) } } ?: consumer.accept(ControlAction.RESPONSE_FAIL) }
자바
@Override public void performControlAction(@NonNull String controlId, @NonNull ControlAction action, @NonNull Consumerconsumer) { ReplayProcessor processor = controlFlows.get(controlId); if (processor == null) return; if (controlId.equals(LIGHT_ID + "")) { consumer.accept(ControlAction.RESPONSE_OK); if (action instanceof BooleanAction) toggleState = ((BooleanAction) action).getNewState(); processor.onNext(createLight()); } if (controlId.equals(THERMOSTAT_ID + "")) { consumer.accept(ControlAction.RESPONSE_OK); if (action instanceof FloatAction) rangeState = ((FloatAction) action).getNewValue() processor.onNext(createThermostat()); } }
앱을 실행하고 기기 제어 메뉴에 액세스한 다음 조명과 온도 조절기 제어
![조명 및 온도 조절기 컨트롤을 보여주는 이미지](https://developer.android.com/static/images/ui/device_controls_example_2.png?hl=ko)