Đọc giao dịch
Một trong những trường hợp sử dụng đầu tiên khi tương tác với các Nút trong Matter là cách đọc Thuộc tính từ một Nút khác, chẳng hạn như giá trị nhiệt độ từ cảm biến. Trong các Tương tác đó, đầu tiên Hành động phải được thực hiện là Hành động yêu cầu đọc.
Hành động yêu cầu đọc
Hướng: Trình khởi tạo -> Đích đến
Trong Hành động này, Trình khởi tạo truy vấn một Mục tiêu cung cấp:
- Yêu cầu thuộc tính: một danh sách không có hoặc có nhiều Thuộc tính của mục tiêu. Danh sách này bao gồm không có hoặc có nhiều Đường dẫn đến mục tiêu được yêu cầu Thuộc tính.
- Yêu cầu sự kiện: danh sách không có hoặc nhiều Đường dẫn đến yêu cầu của Mục tiêu Sự kiện.
Sau khi Mục tiêu nhận được Hành động yêu cầu đọc, hành động này sẽ tập hợp Báo cáo Hành động dữ liệu kèm theo thông tin được yêu cầu.
Thao tác đối với dữ liệu báo cáo
Hướng: Đích -> Trình khởi tạo
Trong Hành động này, Mục tiêu phản hồi bằng:
- Báo cáo thuộc tính: danh sách không có hoặc nhiều Thuộc tính được báo cáo được yêu cầu trong Yêu cầu hành động đọc.
- Báo cáo sự kiện: danh sách gồm 0 hoặc nhiều Sự kiện được báo cáo.
- Chặn phản hồi: cờ xác định liệu trạng thái phản hồi đối với hành động này nên bị chặn.
- Mã đăng ký: nếu báo cáo này là một phần của một giao dịch đăng ký, mã này phải bao gồm một số nguyên dùng để xác định giao dịch thuê bao.
Thao tác phản hồi trạng thái
Hướng: Mục tiêu -> Trình khởi tạo hoặc Trình khởi tạo -> Đích đến
Sau khi nhận được dữ liệu được yêu cầu, theo mặc định, Trình khởi tạo phải tạo Thao tác phản hồi trạng thái. Hành động này được gửi từ Trình khởi tạo, xác nhận dữ liệu được báo cáo. Nếu cờ Phản hồi trạng thái chặn được đặt, Trình khởi tạo không được gửi Hành động phản hồi trạng thái.
Sau khi Người khởi tạo hoặc Dữ liệu báo cáo gửi Hành động phản hồi trạng thái Trình khởi tạo nhận được hành động có cờ Phản hồi chặn, truy vấn đọc/báo cáo đã hoàn tất.
Hành động phản hồi trạng thái chỉ chứa trường trạng thái sẽ xác nhận thao tác thành công hoặc đưa ra mã lỗi.
Hạn chế quyền đọc
Hành động yêu cầu đọc và Hành động báo cáo dữ liệu Chỉ Unicast. Hơn nữa, Đường dẫn của các yêu cầu này có thể không nhắm mục tiêu một Nhóm nút.
Hành động phản hồi trạng thái chỉ có thể là Unicast và không được được tạo làm phản hồi cho một bản ghi nhóm.
Giao dịch đăng ký
Thao tác yêu cầu đăng ký
Hướng: Trình khởi tạo -> Đích đến
Ngoài một Hành động yêu cầu đọc duy nhất, Người khởi tạo cũng có thể đăng ký cho các bản cập nhật định kỳ của một Thuộc tính hoặc Sự kiện. Do đó, cùng một Hành động dữ liệu trong báo cáo có thể được tạo ra do việc cập nhật dữ liệu định kỳ tuân theo Giao dịch đăng ký.
Tương tác gói thuê bao tạo ra mối quan hệ giữa hai Nút, trong đó Mục tiêu tạo định kỳ Hành động dữ liệu báo cáo cho Người khởi tạo. Trình khởi tạo là Người đăng ký và Mục tiêu là Nhà xuất bản.
Hành động yêu cầu đăng ký bao gồm:
- Khoảng thời gian tối thiểu: khoảng thời gian tối thiểu giữa các báo cáo.
- Giá trị trần khoảng thời gian tối đa: khoảng thời gian tối đa giữa các báo cáo.
- Báo cáo thuộc tính: danh sách không có hoặc nhiều Thuộc tính được báo cáo được yêu cầu trong Yêu cầu hành động đọc.
- Báo cáo sự kiện: danh sách không có hoặc nhiều Sự kiện được báo cáo.
Sau Yêu cầu đăng ký, Mục tiêu sẽ phản hồi Trình khởi tạo bằng một Thao tác báo cáo dữ liệu chứa lô dữ liệu đầu tiên đã báo cáo: thao tác Được sử dụng trước Dữ liệu đã xuất bản.
Sau đó, Trình khởi tạo sẽ xác nhận Hành động dữ liệu báo cáo bằng Phản hồi trạng thái Hành động được gửi đến Mục tiêu. Sau khi Mục tiêu nhận được một Hành động phản hồi trạng thái báo cáo không có lỗi, thì Chrome sẽ gửi một Hành động phản hồi đăng ký.
Sau đó, Mục tiêu sẽ định kỳ gửi Hành động dữ liệu báo cáo vào khoảng thời gian đã thương lượng và Trình khởi tạo sẽ phản hồi những Hành động đó cho đến khi gói thuê bao bị mất hoặc bị huỷ.
Thao tác đăng ký phản hồi
Hướng: Đích -> Trình khởi tạo
Đây là Hành động cuối cùng đối với Giao dịch thuê bao và kết thúc của chúng tôi. Thư mục này bao gồm:
- Mã nhận dạng gói thuê bao: một số nguyên xác định gói thuê bao.
- Khoảng thời gian tối thiểu: khoảng thời gian tối thiểu cuối cùng, được xác định giữa .
- Khoảng thời gian tối đa: khoảng thời gian tối đa cuối cùng, được xác định giữa .
Hạn chế về việc đăng ký
- Hành động yêu cầu đăng ký và Hành động phản hồi đăng ký bao gồm Thao tác chỉ dành cho Unicast.
- Tất cả các Thao tác dữ liệu báo cáo trong một Tương tác thuê bao phải có cùng một trạng thái Mã nhận dạng gói thuê bao.
- Nếu Người đăng ký không nhận được Thao tác dữ liệu báo cáo trong tối đa khoảng thời gian đã thương lượng giữa các Hành động, thì gói thuê bao sẽ bị chấm dứt.
- Theo quy tắc trước, Nhà xuất bản có thể chấm dứt Tương tác gói thuê bao bằng cách ngừng gửi Dữ liệu báo cáo định kỳ Thao tác.
- Người đăng ký có thể chấm dứt Tương tác gói thuê bao bằng cách phản hồi một
Báo cáo Hành động dữ liệu có mã trạng thái
INACTIVE_SUBSCRIPTION.