aqara 0.1.1

Aqara SDK for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

use serde_json::json;

use crate::error::Result;
use crate::types::AqaraValueResponse;
use crate::types::devices::{
    QueryDeviceInfoParams, QuerySubDevicesParams, UnbindDeviceParams, UpdateDeviceNameParams,
    UpdateDevicePositionParams,
};

#[cfg(feature = "async")]
use crate::Client;

#[cfg(feature = "blocking")]
use crate::BlockingClient;

/// Device-related APIs (async).
#[cfg(feature = "async")]
#[derive(Clone)]
pub struct DeviceService {
    client: Client,
}

#[cfg(feature = "async")]
impl DeviceService {
    pub(crate) fn new(client: Client) -> Self {
        Self { client }
    }

    /// `query.device.info`.
    pub async fn info(&self, params: QueryDeviceInfoParams) -> Result<AqaraValueResponse> {
        let mut data = json!({
            "positionId": params.position_id.unwrap_or_default(),
            "pageNum": params.page_num,
            "pageSize": params.page_size,
        });
        if let Some(dids) = params.dids {
            data["dids"] = json!(dids);
        }
        self.client
            .call_json("query.device.info", data, true, true)
            .await
    }

    /// `query.device.subInfo`.
    pub async fn sub_info(&self, params: QuerySubDevicesParams) -> Result<AqaraValueResponse> {
        let data = json!({ "did": params.gateway_did });
        self.client
            .call_json("query.device.subInfo", data, true, true)
            .await
    }

    /// `config.device.name`.
    pub async fn update_name(&self, params: UpdateDeviceNameParams) -> Result<AqaraValueResponse> {
        let data = json!({
            "did": params.did,
            "name": params.name,
        });
        self.client
            .call_json("config.device.name", data, true, false)
            .await
    }

    /// `config.device.position`.
    pub async fn update_position(
        &self,
        params: UpdateDevicePositionParams,
    ) -> Result<AqaraValueResponse> {
        let data = json!({
            "dids": params.dids,
            "positionId": params.position_id,
        });
        self.client
            .call_json("config.device.position", data, true, false)
            .await
    }

    /// `write.device.unbind`.
    pub async fn unbind(&self, params: UnbindDeviceParams) -> Result<AqaraValueResponse> {
        let data = json!({ "did": params.did });
        self.client
            .call_json("write.device.unbind", data, true, false)
            .await
    }
}

/// Device-related APIs (blocking).
#[cfg(feature = "blocking")]
#[derive(Clone)]
pub struct BlockingDeviceService {
    client: BlockingClient,
}

#[cfg(feature = "blocking")]
impl BlockingDeviceService {
    pub(crate) fn new(client: BlockingClient) -> Self {
        Self { client }
    }

    /// `query.device.info`.
    pub fn info(&self, params: QueryDeviceInfoParams) -> Result<AqaraValueResponse> {
        let mut data = json!({
            "positionId": params.position_id.unwrap_or_default(),
            "pageNum": params.page_num,
            "pageSize": params.page_size,
        });
        if let Some(dids) = params.dids {
            data["dids"] = json!(dids);
        }
        self.client.call_json("query.device.info", data, true, true)
    }

    /// `query.device.subInfo`.
    pub fn sub_info(&self, params: QuerySubDevicesParams) -> Result<AqaraValueResponse> {
        let data = json!({ "did": params.gateway_did });
        self.client
            .call_json("query.device.subInfo", data, true, true)
    }

    /// `config.device.name`.
    pub fn update_name(&self, params: UpdateDeviceNameParams) -> Result<AqaraValueResponse> {
        let data = json!({
            "did": params.did,
            "name": params.name,
        });
        self.client
            .call_json("config.device.name", data, true, false)
    }

    /// `config.device.position`.
    pub fn update_position(
        &self,
        params: UpdateDevicePositionParams,
    ) -> Result<AqaraValueResponse> {
        let data = json!({
            "dids": params.dids,
            "positionId": params.position_id,
        });
        self.client
            .call_json("config.device.position", data, true, false)
    }

    /// `write.device.unbind`.
    pub fn unbind(&self, params: UnbindDeviceParams) -> Result<AqaraValueResponse> {
        let data = json!({ "did": params.did });
        self.client
            .call_json("write.device.unbind", data, true, false)
    }
}