Aracılığıyla paylaş

Twin class

  • Başvuru
Paket:
azure-iothub

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 | DeviceIdentity, Registry)

Yeni bir Twinörneği oluşturur. Yeni bir Twin nesnesi edinmenin önerilen yolu getTwin(string, HttpResponseCallback<Twin>) yöntemini kullanmaktır.

Özellikler

deviceId

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.
modelId

Cihaz kimliği kayıt defterinde mevcut olduğundan, ikizle ilişkili cihaz kimliğinin model kimliği.
moduleId

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 properties.desired ve properties.reported).
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(IncomingMessageCallback<Twin>)

IoT Hub hizmetinden bu cihaz ikizinin en son sürümünü alır.
toJSON()
update(any)
update(any, IncomingMessageCallback<Twin>)

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

done

IncomingMessageCallback<Twin>

İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done üç bağımsız değişkenle çağrılır: Hata nesnesi (null olabilir), oluşturulan cihaz kimliğini temsil eden İkiz nesnesi ve günlüğe kaydetme veya hata ayıklama için yararlı olan aktarıma özgü yanıt nesnesi.

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.

done

IncomingMessageCallback<Twin>

İşlem tamamlandığında çağrılacak isteğe bağlı işlev. done üç bağımsız değişkenle çağrılır: Hata nesnesi (null olabilir), oluşturulan cihaz kimliğini temsil eden İkiz nesnesi ve günlüğe kaydetme veya hata ayıklama için yararlı olan aktarıma özgü yanıt nesnesi.