Thao tác với thiết bị
Người tìm kiếm có thể yêu cầu Nhà cung cấp thực hiện hành động. Nếu Hành động được hỗ trợ bởi Nhà cung cấp, thì bạn nên xác nhận và thực hiện hành động đó, nếu không thì bạn nên bỏ qua.
Tên nhóm thông báo | Giá trị |
---|---|
Sự kiện hành động trên thiết bị | 0x04 |
Tên mã tác vụ của thiết bị | Giá trị |
---|---|
Đổ chuông | 0x01 |
Đổ chuông thiết bị
Một trường hợp sử dụng của những hành động này là Người tìm kiếm yêu cầu Nhà cung cấp đổ chuông, chẳng hạn như khi người dùng đã mất thiết bị và cần tìm thiết bị đó. Khi nhận được hành động đổ chuông, Nhà cung cấp sẽ bắt đầu phát tệp âm thanh được tải trước ở mức âm lượng đủ lớn để người dùng có thể xác định. Bạn nên tăng âm lượng từ mức thấp đến mức tối đa theo thời gian. Đổ chuông sẽ tiếp tục cho đến khi nhận được một hành động bổ sung để chuyển hướng điểm dừng hoặc chuyển giá trị thời gian chờ.
Dữ liệu bổ sung sẽ được đưa vào thông báo để cho biết liệu bạn nên bắt đầu hay dừng đổ chuông. Thông tin này có thể được mở rộng để hỗ trợ Nhà cung cấp có nhiều thành phần (tờ trái và tai nghe phải). Trong byte đầu tiên, các bit sẽ được đặt thành 1 để yêu cầu chuông bắt đầu hoặc 0 để yêu cầu đổ chuông.
Ví dụ: nếu byte đầu tiên của dữ liệu bổ sung được đặt thành:
- 0x00 (0b00000000): Tất cả các thành phần phải ngừng đổ chuông
- 0x01 (0b00000001): Đổ chuông bên phải, ngừng đổ chuông sang trái
- 0x02 (0b00000010): Đổ chuông bên trái, ngừng đổ chuông bên phải
- 0x03 (0b00000011): Đổ chuông cả bên trái và bên phải
Trên những Nhà cung cấp không hỗ trợ đổ chuông riêng lẻ, bạn chỉ nên xem xét 1 bit:
- 0x00 (0b00000000): Dừng đổ chuông
- 0x01 (0b00000001): Bắt đầu đổ chuông
Byte thứ hai trong dữ liệu bổ sung, nếu có, biểu thị thời gian chờ tính bằng giây. Nhà cung cấp nên sử dụng giá trị này để xác định thời lượng đổ chuông trước khi tắt tiếng. Dựa trên ví dụ về vòng nhẫn ở trên và thời gian chờ 60 giây, 0x013C
sẽ được chuyển dưới dạng dữ liệu bổ sung.
Đang đồng bộ hoá trạng thái đổ chuông lại cho Người tìm kiếm
Nhà cung cấp có thể thông báo cho Người tìm kiếm khi thay đổi trạng thái đổ chuông, ví dụ nếu một cử chỉ khiến đổ chuông dừng. Sau đó, Trình tìm kiếm có thể nhận thông báo và cập nhật giao diện người dùng nếu cần.
Trình cung cấp phải tuân theo định dạng thông báo giống như định nghĩa trong ví dụ ở trên. Người tìm kiếm sẽ lắng nghe thư này và cung cấp thông tin xác nhận khi nhận được thư.
Xác nhận một hành động
Khi nhận được một hành động, bạn cần xác nhận hành động đó để người tìm kiếm biết liệu hành động đó có được thực hiện hay không. Nếu không nhận được thông báo xác nhận trong vòng 1 giây kể từ khi gửi một hành động (hoặc nhận được một xác nhận phủ định), người tìm kiếm sẽ cho rằng hành động đó hiện không được hỗ trợ.