거의 모든 멀티스크린 경험은 사용 가능한 기기를 찾는 것에서 시작됩니다. 이 일반적인 작업을 간소화하기 위해 Device Discovery API를 제공합니다.
기기 선택 대화상자 실행
기기 검색은 시스템 대화상자를 사용하여 사용자가 대상 기기를 선택할 수 있도록 합니다. 기기 선택 대화상자를 시작하려면 먼저 기기 검색 클라이언트를 가져오고 결과 수신기를 등록해야 합니다. registerForActivityResult
와 마찬가지로 이 broadcast receiver는 무조건 활동 또는 프래그먼트 초기화 경로의 일부로 등록되어야 합니다.
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) devicePickerLauncher = Discovery.create(this).registerForResult(this, handleDevices) }
Java
@Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); devicePickerLauncher = Discovery.create(this).registerForResult(this, handleDevices); }
위의 코드 스니펫에는 정의되지 않은 handleDevices
객체가 있습니다. 사용자가 연결할 기기를 선택하고 SDK가 다른 기기에 성공적으로 연결되면 이 콜백은 선택된 Participants
목록을 수신합니다.
Kotlin
handleDevices = OnDevicePickerResultListener { participants -> participants.forEach { // Use participant info } }
Java
handleDevices = participants -> { for (Participant participant : participants) { // Use participant info } }
기기 선택 도구가 등록되면 devicePickerLauncher
인스턴스를 사용하여 실행합니다. DevicePickerLauncher.launchDevicePicker
는 두 가지 매개변수, 즉 기기 필터 목록 (아래 섹션 참고)과 startComponentRequest
를 사용합니다. startComponentRequest
는 수신 기기에서 시작해야 하는 활동과 사용자에게 표시되는 요청 이유를 나타내는 데 사용됩니다.
Kotlin
devicePickerLauncher.launchDevicePicker( listOf(), startComponentRequest { action = "com.example.crossdevice.MAIN" reason = "I want to say hello to you" }, )
Java
devicePickerLauncher.launchDevicePickerFuture( Collections.emptyList(), new StartComponentRequest.Builder() .setAction("com.example.crossdevice.MAIN") .setReason("I want to say hello to you") .build());
연결 요청 수락
사용자가 기기 선택 도구에서 기기를 선택하면 수신 기기에 사용자에게 연결을 수락하도록 요청하는 대화상자가 표시됩니다. 수락되면 타겟 활동이 실행되며 onCreate
및 onNewIntent
에서 처리할 수 있습니다.
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) handleIntent(getIntent()) } override fun onNewIntent(intent: Intent) { super.onNewIntent(intent) handleIntent(intent) } private fun handleIntent(intent: Intent) { val participant = Discovery.create(this).getParticipantFromIntent(intent) // Accept connection from participant (see below) }
Java
@Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); handleIntent(getIntent()); } @Override public void onNewIntent(Intent intent) { super.onNewIntent(intent); handleIntent(intent); } private void handleIntent(Intent intent) { Participant participant = Discovery.create(this).getParticipantFromIntent(intent); // Accept connection from participant (see below) }
기기 필터
기기를 검색할 때는 당면한 사용 사례와 관련된 기기만 표시하도록 이러한 기기를 필터링하는 것이 일반적입니다. 예:
- 카메라가 있는 기기로만 필터링하여 QR 코드 스캔 지원
- 대형 화면 시청 환경을 위해 TV로만 필터링
이 개발자 프리뷰에서는 동일한 사용자가 소유한 기기를 필터링하는 기능부터 시작합니다.
DeviceFilter
클래스를 사용하여 기기 필터를 지정할 수 있습니다.
Kotlin
val deviceFilters = listOf(DeviceFilter.trustRelationshipFilter(MY_DEVICES_ONLY))
Java
List<DeviceFilter> deviceFilters = Arrays.asList(DeviceFilter.trustRelationshipFilter(MY_DEVICES_ONLY));
기기 필터를 정의한 후에는 기기 검색을 시작할 수 있습니다.
Kotlin
devicePickerLauncher.launchDevicePicker(deviceFilters, startComponentRequest)
Java
Futures.addCallback( devicePickerLauncher.launchDevicePickerFuture(deviceFilters, startComponentRequest), new FutureCallback<Void>() { @Override public void onSuccess(Void result) { // do nothing, result will be returned to handleDevices callback } @Override public void onFailure(Throwable t) { // handle error } }, mainExecutor);
launchDevicePicker
는 suspend
키워드를 사용하는 비동기 함수입니다.