컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
제공업체는 메시지 스트림을 통해 검색자에게 기기 정보를 알릴 수 있습니다.
| 메시지 그룹 이름 |
값 |
| 기기 정보 이벤트 |
0x03 |
| 기기 정보 코드명 |
값 |
| 모델 ID |
0x01 |
| BLE 주소가 업데이트됨 |
0x02 |
| 배터리 업데이트됨 |
0x03 |
| 남은 배터리 시간 |
0x04 |
| 활성 구성요소 요청 |
0x05 |
| 활성 구성요소 응답 |
0x06 |
| (지원 중단됨)기능 |
0x07 |
| 플랫폼 유형 |
0x08 |
| 펌웨어 버전 |
0x09 |
| 현재 FHN 일회용 식별자 |
0x0B |
모델 ID
모델 ID 정보 (AccountKey를 소급하여 작성)는 RFCOMM이 연결될 때 시커로 전송되어야 합니다. 예를 들어 0x03010003AABBCC는 다음과 같습니다.
- 0x03: 기기 정보 이벤트
- 0x01: 모델 ID 값
- 0x0003: 추가 데이터, 길이 3
- 0xAABBCC: 추가 데이터, 모델 ID
BLE 주소
BLE 주소 정보 (AccountKey를 소급하여 작성용)도 가능한 경우 RFCOMM이 연결될 때와 주소가 회전할 때마다 시커에 전송해야 합니다. 예를 들어 0x03020006AABBCCDDEEFF는 다음과 같습니다.
- 0x03: 기기 정보 이벤트
- 0x02: BLE 주소 값
- 0x0006: 추가 데이터, 길이 6
- 0xAABBCCDDEEFF: 추가 데이터, BLE 주소
배터리 업데이트됨
배터리 알림을 지원하는 제공업체의 경우 배터리 정보를 RFCOMM을 통해 전송할 수도 있습니다. RFCOMM이 연결되거나 배터리 값이 변경되면 업데이트를 전송해야 합니다. BLE를 통해 배터리 데이터를 광고할 때 패킷의 추가 데이터 섹션에는 바이트 s + 2, s + 3, s + 4와 동일한 데이터가 포함되어야 합니다. 예를 들어 0x0303000357417F는 다음과 같습니다.
- 0x03: 기기 정보 이벤트
- 0x03: 배터리 값
- 0x0003: 추가 데이터, 길이 3
- 0x57417F: 추가 데이터, 배터리 값
- 0x57: 왼쪽 이어폰 값, 충전 중 아님, 배터리 87%
- 0x41: 오른쪽 이어폰 값, 충전 중 아님, 배터리 65%
- 0x7F: 케이스 값, 충전 중 아님, 배터리 알 수 없음
공급자는 남은 배터리 시간을 업데이트할 수도 있습니다 (알려진 경우). 예를 들어 0x03040001F0는 다음과 같습니다.
- 0x03: 기기 정보 이벤트
- 0x04: 남은 배터리 시간
- 0x0001: 추가 데이터, 길이 1 (필요한 경우 uint16의 경우 2일 수 있음)
- 0xF0: 추가 데이터, 남은 배터리 시간(분), 240분
활성 구성요소
검색자는 현재 활성 상태이므로 작업을 실행할 수 있는 구성요소를 알고 싶어 할 수 있습니다 (기기 작업 참고).
공급자가 활성 구성요소 요청 코드 (0x05)가 포함된 요청을 수신하면 1초 이내에 공급자의 현재 상태를 나타내는 응답을 반환해야 합니다. 응답은 활성 구성요소 응답 코드 (0x06)를 사용하고 사용 가능한 구성요소를 나타내는 추가 데이터를 포함합니다.
구성요소가 하나인 제공자의 경우 추가 데이터를 사용할 수 없는 경우 0x00으로 설정해야 합니다. 미디어 재생이 실행되지 않는 저전력 모드가 그 예입니다. 그 외의 경우에는 추가 데이터를 0x01로 설정해야 합니다.
구성요소가 여러 개인 헤드셋 (예: 좌우 이어폰)의 경우 추가 데이터의 각 비트는 해당 구성요소가 활성 상태인지 나타냅니다. 비활성 구성요소의 예로는 케이스에 있고 사용하지 않는 버드가 있습니다. 특히 왼쪽 및 오른쪽 이어폰 케이스의 경우:
- 0x00 (0b00000000): 어느 쪽도 활성 상태가 아님
- 0x01 (0b00000001): 오른쪽 이어폰이 활성 상태이고 왼쪽 이어폰이 비활성 상태임
- 0x02 (0b00000010): 왼쪽 이어폰이 활성 상태이고 오른쪽 이어폰이 비활성 상태입니다.
- 0x03 (0b00000011): 양쪽 이어폰 모두 활성 상태
제공업체는 연결된 플랫폼에 따라 다르게 실행할 수 있습니다. 빠른 페어링은 현재 Android를 통해서만 실행되지만 향후 지원 범위가 확대될 수 있습니다.
메시지에는 추가 데이터에서 플랫폼 유형을 식별하는 첫 번째 바이트가 포함됩니다.
두 번째 바이트는 플랫폼별로 맞춤설정됩니다. Android에서는 SDK 버전을 참조합니다. 예를 들어 Android Pie의 값은 28 (0x1C)입니다.
펌웨어 버전
제공업체의 펌웨어 버전(UTF-8 인코딩의 문자열)입니다.
펌웨어 버전 특성의 정보와 동일합니다.
현재 FHN 일회성 식별자
FHN 프레임을 광고하는 제공업체는 시계 오류 (예: 배터리 소진)가 발생할 경우 시커와 동기화하기 위해 현재 시계 값과 함께 현재 FHN 임시 식별자 (EID)를 보고해야 합니다.
예를 들면 다음과 같습니다.
- 0x03: 기기 정보 이벤트
- 0x0B: 현재 FHN 일회용 식별자 메시지
- 0x0018: 추가 데이터, 길이 24바이트 또는 36바이트
- 0x13F9EA80: 추가 데이터 (시계 값, 4바이트)
- 0x1122334455667788990011223344556677889900: 추가 데이터 (현재 EID, 20바이트 또는 32바이트)
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-13(UTC)
[null,null,["최종 업데이트: 2025-08-13(UTC)"],[[["\u003cp\u003eProviders can notify a Seeker about device information like Model ID, BLE address, battery status, and active components using a dedicated message stream.\u003c/p\u003e\n"],["\u003cp\u003eDevice information is communicated using specific event codes and additional data formats, allowing Seekers to understand the Provider's state.\u003c/p\u003e\n"],["\u003cp\u003eProviders can share details like platform type and firmware version for compatibility checks and tailored interactions.\u003c/p\u003e\n"],["\u003cp\u003eBattery information can be communicated using the Battery Updated event and include details such as battery level, charging status, and remaining time.\u003c/p\u003e\n"],["\u003cp\u003eActive components information helps Seekers to understand which device functionalities are available at the given time.\u003c/p\u003e\n"]]],[],null,["Device information\n------------------\n\nProviders can notify a Seeker about device information via the\n[message stream](#MessageStream).\n\n| Message Group Name | Value |\n|--------------------------|-------|\n| Device information event | 0x03 |\n\n| Device Information Code Name | Value |\n|----------------------------------|-------|\n| Model ID | 0x01 |\n| BLE address updated | 0x02 |\n| Battery updated | 0x03 |\n| Remaining battery time | 0x04 |\n| Active components request | 0x05 |\n| Active components response | 0x06 |\n| (Deprecated)Capabilities | 0x07 |\n| Platform type | 0x08 |\n| Firmware version | 0x09 |\n| Current FHN ephemeral identifier | 0x0B |\n\n### Model ID\n\nModel ID information (for\n[Retroactively Writing AccountKey](/nearby/fast-pair/specifications/extensions/retroactiveacctkey#RetroactivelyWritingAccountKey \"Retroactively Writing Account key\")) should be\nsent to the Seeker when RFCOMM connects. For example, `0x03010003AABBCC`\nwould be:\n\n- 0x03: Device information event\n- 0x01: Model ID value\n- 0x0003: Additional data, length 3\n- 0xAABBCC: Additional data, model ID\n\n### BLE address\n\nBLE address information (for\n[Retroactively Writing AccountKey](/nearby/fast-pair/specifications/extensions/retroactiveacctkey#RetroactivelyWritingAccountKey \"Retroactively Writing Account key\")) , if\navailable, should also be sent to the Seeker when RFCOMM connects and whenever\nthe address is rotated. For example, `0x03020006AABBCCDDEEFF` would be:\n\n- 0x03: Device information event\n- 0x02: BLE address value\n- 0x0006: Additional data, length 6\n- 0xAABBCCDDEEFF: Additional data, BLE address\n\n### Battery updated\n\nFor Providers that support [battery notifications](/nearby/fast-pair/specifications/extensions/batterynotification#BatteryNotification \"Battery Notification\"),\nbattery information can also be sent via RFCOMM. When RFCOMM connects or the\nbattery value changes, an update should be sent. The additional data section of\nthe packet should contain identical data to bytes *s + 2* , *s + 3* , *s + 4* when\nadvertising battery data over BLE. For example,`0x0303000357417F` would be:\n\n- 0x03: Device information event\n- 0x03: Battery value\n- 0x0003: Additional data, length 3\n- 0x57417F: Additional data, battery values\n - 0x57: Left bud value, not charging, 87% battery\n - 0x41: Right bud value, not charging, 65% battery\n - 0x7F: Case value, not charging, unknown battery\n\nProviders can also update remaining battery time (if known), For example,\n`0x03040001F0` would be:\n\n- 0x03: Device information event\n- 0x04: Remaining battery time\n- 0x0001: Additional data, length 1 (could be 2 for uint16 if needed.)\n- 0xF0: Additional data, remaining battery time in minutes, 240 minutes\n\n### Active components\n\nSeekers may sometimes desire to know which components are currently active,\nmeaning that an action can be taken on them (see [Device actions](/nearby/fast-pair/specifications/extensions/deviceaction#DeviceAction \"Message Stream: Device Actions\")).\nWhen the Provider receives a request containing the\n*active components request* code (0x05), a response should be returned within 1\nsecond indicating the Provider's current state. The response will use the\n*active components response* code (0x06) and contain additional data indicating\nwhich components are available.\n\nFor a Provider with a single component, the additional data should be set to\n0x00 if it is not available. An example of this might be a low power mode where\nmedia playback will not be performed. Otherwise, additional data should be set\nto 0x01.\n\nFor headsets with multiple components (for example, a left and right bud), each\nbit in the additional data represents whether that component is active. An\nexample of an inactive component might be a bud which is in the case and not in\nuse. Specifically for the left and right bud case:\n\n- 0x00 (0b00000000): Neither bud active\n- 0x01 (0b00000001): Right bud active, left inactive\n- 0x02 (0b00000010): Left bud active, right inactive\n- 0x03 (0b00000011): Both buds active\n\n### Platform Type\n\nProviders may want to perform differently based on the platform that they are\nconnected to. Fast Pair is currently only performed through Android, but support\nmay be expanded in the future.\n\nThe message will contain a first byte identifying platform type in the\nadditional data:\n\n| Platform Name | Value |\n|---------------|-------|\n| Android | 0x01 |\n\nThe second byte will be customized per platform. In Android, it will refer to the\n[SDK version](https://source.android.com/setup/start/build-numbers). For\nexample, Android Pie will have a value of 28 (0x1C).\n\n### Firmware version\n\nThe provider's firmware version as a string in utf-8 encoding.\nIt's the same information as in the [Firmware revision characteristic](/nearby/fast-pair/specifications/characteristics#FirmwareRevision \"Firmware revision characteristic\").\n\n### Current FHN Ephemeral Identifier\n\nProviders that advertise FHN frames should report the current FHN Ephemeral\nIdentifier (EID) with their current clock value to sync with the Seeker in case\nof a clock drift (for example, due to drained battery).\n\nFor example:\n\n- 0x03: Device information event\n- 0x0B: Current FHN ephemeral identifier message\n- 0x0018: Additional data, length 24 or 36 bytes\n- 0x13F9EA80: Additional data (clock value; 4 bytes)\n- 0x1122334455667788990011223344556677889900: Additional data (current EID; 20 or 32 bytes)"]]
