Hành động trên thiết bị

Người tìm kiếm có thể yêu cầu Nhà cung cấp thực hiện một hành động. Nếu Nhà cung cấp hỗ trợ hành động này, thì hành động đó phải được xác nhận và thực hiện, nếu không thì hành động đó sẽ bị bỏ qua.

Tên nhóm tin nhắn Giá trị
Sự kiện hành động trên thiết bị 0x04
Tên mã hành động của thiết bị Giá trị
Đổ chuông 0x01

Đổ chuông thiết bị

Một trường hợp sử dụng cho các thao tác 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 làm mất thiết bị và cần xác định vị trí của thiết bị. Khi nhận được thao tác đổ chuông, Nhà cung cấp sẽ bắt đầu phát một tệp âm thanh được tải sẵn ở âm lượng đủ lớn để người dùng có thể xác định vị trí của thiết bị. Bạn nên tăng dần âm lượng từ thấp đến tối đa theo thời gian. Chuông sẽ tiếp tục đổ chuông cho đến khi nhận được một hành động khác yêu cầu dừng hoặc đã hết thời gian chờ.

Dữ liệu bổ sung sẽ được đưa vào thông báo để cho biết có nên bắt đầu hoặc dừng đổ chuông hay không. Dữ liệu này có thể được mở rộng để hỗ trợ Nhà cung cấp có nhiều thành phần (tai nghe bên trái và bên phải). Trong byte đầu tiên, các bit sẽ được đặt thành 1 để yêu cầu bắt đầu đổ chuông hoặc 0 để yêu cầu dừng đổ 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 bên 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ợ chế độ đổ chuông riêng lẻ, chỉ nên xem xét 1 bit:

  • 0x00 (0b00000000): Ngừng đổ chuông
  • 0x01 (0b00000001): Bắt đầu đổ chuông

Nếu có, byte thứ hai trong dữ liệu bổ sung sẽ 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 gian đổ chuông trước khi tự tắt tiếng. Dựa trên ví dụ về quyền đổ chuông ở trên và thời gian chờ là 60 giây, 0x013C sẽ được truyền dưới dạng dữ liệu bổ sung.

Đồng bộ hoá trạng thái đổ chuông trở lại với Người tìm kiếm

Các Nhà cung cấp có thể muốn thông báo cho Người tìm kiếm khi Người tìm kiếm thay đổi trạng thái đổ chuông, ví dụ: nếu một cử chỉ khiến chuông ngừng đổ. Sau đó, Người tìm kiếm có thể nhận được thông báo và cập nhật giao diện người dùng nếu cần.

Nhà cung cấp phải tuân theo cùng một định dạng thông báo như được xác định trong ví dụ ở trên. Seeker sẽ lắng nghe thông báo này và đưa ra thông báo xác nhận khi nhận được thông báo.

Xác nhận một hành động

Khi nhận được một thao tác, thao tác đó phải được xác nhận để Seeker biết thao tác đó có được thực hiện hay không. Nếu không nhận được tín hiệu xác nhận trong vòng 1 giây kể từ khi gửi một thao tác (hoặc nhận được tín hiệu xác nhận tiêu cực), thì Seeker sẽ giả định rằng thao tác đó hiện không được hỗ trợ.