Data Layer API를 사용하여 네트워크에서 기기 탐색

기기는 Wi-Fi 또는 모바일 데이터 연결을 사용하여 직접, 또는 페어링된 블루투스 기기를 통해 간접적으로 인터넷에 연결할 수 있습니다.

연결 가능한 주변 노드

기기가 온라인 상태이고 블루투스를 통해 직접 또는 클라우드를 중개자로 사용하여 간접적으로 다른 기기와 통신할 수 있는 경우 연결 가능한 것으로 간주됩니다.

클라우드를 사용하지 않고 블루투스를 통해 직접 연결할 수 있는 경우 기기가 근처에 있는 것으로 간주됩니다.

재연결 시간에 영향을 미치는 활동

특정 상황에서는 기기가 연결을 다시 설정하는 데 최대 4분이 걸릴 수 있습니다. 이러한 시나리오에는 다음이 포함됩니다.

  • Wear OS 기기 비활성: Wear OS 기기가 사용자의 손목에서 분리되거나 장시간 사용되지 않으면 재연결 시간이 연장될 수 있습니다.
  • 잠자기 상태: 휴대기기의 절전 잠자기 상태는 백그라운드 프로세스를 제한하여 기기의 재연결 시간을 늘릴 수 있습니다.
  • 사용자 상호작용: 사용자가 휴대기기와 Wear OS 기기 모두와 거의 동시에 상호작용을 시작하면 재연결 프로세스가 빨라지는 경우가 많습니다.

노드 클라이언트를 사용하여 모든 기기 검색

NodeClient 객체는 각 기기의 기능과 관계없이 네트워크에 연결된 Android 지원 기기 목록을 식별하고 브로드캐스트합니다. 기기의 모든 앱은 네트워크에 참여하는 새 기기 또는 오프라인 상태가 되는 기존 기기와 같은 이벤트 알림을 수신합니다.

NodeClient 클래스는 앱이 설치되지 않은 기기를 검색하는 데 특히 유용합니다.

기기 연결 및 연결 해제 이벤트를 등록하려면 Horologist DataLayerAppHelper 클래스를 사용하면 됩니다. 연결 상태를 관찰할 수 있는 connectedAndInstalledNodes Flow를 제공합니다. 또한 connectedNodes() 메서드는 연결된 기기 목록을 반환하여 NodeClient 및 CapabilityClient의 정보를 단일 객체로 결합합니다.

기능 클라이언트를 사용하여 특정 기기 검색

CapabilityClient 객체는 Wear OS 네트워크의 어느 기기가 특정 앱 기능을 지원하는지에 관한 정보를 제공합니다. 기능은 앱이 빌드 시간에 정의하거나 런타임에 동적으로 구성하는 기능입니다.

예를 들어 모바일 Android 앱에서는 동영상 재생의 원격 제어를 지원한다고 알릴 수 있습니다. 해당 앱의 Wear OS 버전은 CapabilityClient를 사용하여 모바일 버전의 앱이 근처 기기에 설치되어 있고 이 기능을 지원하는지 확인할 수 있습니다. 지원하는 경우 Wear OS 앱은 재생 및 일시중지 버튼을 표시하여 사용자가 Wear OS 기기에서 휴대기기에서 재생 중인 동영상을 제어할 수 있습니다. 기능 브로드캐스트는 반대 방향으로도 작동합니다. Wear OS 앱은 지원하는 기능을 나열할 수 있습니다.

빌드 시간에 기능을 정의하려면 앱 감지를 위해 기능 이름 지정에 표시된 대로 res/values/wear.xml에서 android_wear_capabilities라는 string-array 리소스를 선언합니다. 리소스 축소로 인해 android_wear_capabilities가 사용되지 않는 것으로 삭제되지 않도록 하려면 res/values/wear.xml가 아닌 res/raw/ 디렉터리(예: res/raw/keep.xml)의 별도 유지 파일에 tools:keep="@array/android_wear_capabilities"를 지정합니다. 보관 파일 문법은 유지할 리소스 맞춤설정을 참고하세요.

앱의 새로운 기능 확인

CapabilityClient를 사용하여 통신해야 하는 기기의 노드 ID를 확인합니다. 예를 들어 휴대기기에서 앱에 새 기능이 있는지 확인해야 하는 경우 휴대기기 측에 새 기능의 기능을 만듭니다. 그러면 Wear OS 앱은 이 기능을 지원하는 기기를 쿼리할 수 있습니다. 모든 기기에 기능이 없는 경우 사용자가 이 기능을 지원하는 앱 버전을 가지고 있지 않다는 의미이며, 이는 앱 로직에서 적절하게 처리해야 합니다. 휴대기기가 항상 통신할 올바른 노드라고 가정하면 휴대전화 앱이 이 기능을 지원하지 않으므로 메시지가 전송되지 않을 수 있습니다.

Wear OS 기기가 네트워크에 있는 유일한 기기인지 확인

CapabilityClient를 사용하여 근처에 다른 Android 지원 기기가 없기 때문에 앱이 독립형 모드로 작동해야 하는지 확인할 수 있습니다. FILTER_ALL를 전달하면 다른 기기가 결과에 표시되지 않습니다.