Twin class
Cihaz İkizi, Azure IoT hub'ı tarafından depolanan ve cihaz çevrimdışı olsa bile kullanılabilen bir cihazın durumunu açıklayan belgedir. Yaklaşık 3 bölüme sahiptir:
- Etiketler: anahtar/değer çiftlerine yalnızca hizmet tarafından erişilebilir
- İstenen Özellikler: Bir hizmet tarafından güncelleştirildi ve cihaz tarafından alındı
- Bildirilen Özellikler: cihaz tarafından güncelleştirildi ve hizmet tarafından alındı.
Bu bir olasılık olsa da, istenen ve bildirilen özelliklerin eşleşmesi gerekmediğini ve gerekirse bu iki koleksiyonu eşitleme mantığının SDK kullanıcısına bırakıldığını unutmayın.
Daha fazla bilgi için bkz. Device Twins'i anlama.
Belirli bir cihaz için Twin almanın önerilen yolu getTwin(string, HttpResponseCallback<Twin>) yöntemini kullanmaktır.
Oluşturucular
Twin(string | Device |
Yeni bir Twinörneği oluşturur. Yeni bir Twin nesnesi edinmenin önerilen yolu getTwin(string, HttpResponseCallback<Twin>) yöntemini kullanmaktır. |
Özellikler
device |
cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkili cihaz kimliğinin benzersiz tanımlayıcısı. |
etag | Cihaz ikizinin birden çok paralel sürümünü önlemek için iyimser eşzamanlılıkta kullanılan etiket. |
model |
Cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkili cihaz kimliğinin model kimliği. |
module |
Cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkilendirilmiş modülün modül tanımlayıcısı. |
properties | İstenen ve bildirilen özellikler sözlükleri (sırasıyla |
tags | Yalnızca hizmet tarafında kullanılabilen ve belirli cihazları bulmak için sorgularda kullanılabilen anahtar/değer çiftleri koleksiyonu. |
Yöntemler
get() | |
get(Incoming |
IoT Hub hizmetinden bu cihaz ikizinin en son sürümünü alır. |
toJSON() | |
update(any) | |
update(any, Incoming |
Cihaz ikizini bağımsız değişken olarak sağlanan düzeltme eki ile güncelleştirin. |
Oluşturucu Ayrıntıları
Twin(string | DeviceIdentity, Registry)
Yeni bir Twinörneği oluşturur. Yeni bir Twin nesnesi edinmenin önerilen yolu getTwin(string, HttpResponseCallback<Twin>) yöntemini kullanmaktır.
new Twin(device: string | DeviceIdentity, registryClient: Registry)
Parametreler
- device
-
string | DeviceIdentity
Cihaz tanımlayıcı dizesi veya cihazı açıklayan bir nesne. Bir Object ise, bir deviceId özelliği içermelidir.
- registryClient
- Registry
REST API çağrılarını yürütmek için kullanılan HTTP kayıt defteri istemcisi.
Özellik Ayrıntıları
deviceId
cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkili cihaz kimliğinin benzersiz tanımlayıcısı.
deviceId: string
Özellik Değeri
string
etag
Cihaz ikizinin birden çok paralel sürümünü önlemek için iyimser eşzamanlılıkta kullanılan etiket.
etag: string
Özellik Değeri
string
modelId
Cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkili cihaz kimliğinin model kimliği.
modelId?: string
Özellik Değeri
string
moduleId
Cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkilendirilmiş modülün modül tanımlayıcısı.
moduleId?: string
Özellik Değeri
string
properties
İstenen ve bildirilen özellikler sözlükleri (sırasıyla properties.desired
ve properties.reported
).
properties: { desired: {[key: string]: any}, reported: {[key: string]: any} }
Özellik Değeri
{ desired: {[key: string]: any}, reported: {[key: string]: any} }
tags
Yalnızca hizmet tarafında kullanılabilen ve belirli cihazları bulmak için sorgularda kullanılabilen anahtar/değer çiftleri koleksiyonu.
tags: {[key: string]: string}
Özellik Değeri
{[key: string]: string}
Yöntem Ayrıntıları
get()
function get(): Promise<ResultWithIncomingMessage<Twin>>
Döndürülenler
Promise<ResultWithIncomingMessage<Twin>>
get(IncomingMessageCallback<Twin>)
IoT Hub hizmetinden bu cihaz ikizinin en son sürümünü alır.
function get(done?: IncomingMessageCallback<Twin>)
Parametreler
toJSON()
function toJSON(): object
Döndürülenler
object
update(any)
function update(patch: any): Promise<ResultWithIncomingMessage<Twin>>
Parametreler
- patch
-
any
Döndürülenler
Promise<ResultWithIncomingMessage<Twin>>
update(any, IncomingMessageCallback<Twin>)
Cihaz ikizini bağımsız değişken olarak sağlanan düzeltme eki ile güncelleştirin.
function update(patch: any, done?: IncomingMessageCallback<Twin>)
Parametreler
- patch
-
any
Bu cihaz ikizi için uygulanacak yeni değerleri içeren nesne.