次の方法で共有


Twin class

Device Twin は、Azure IoT ハブによって格納され、デバイスがオフラインの場合でも使用できるデバイスの状態を説明するドキュメントです。 これは、次の 3 つのセクションを中心に構築されています。

  • タグ: サービス側からのみアクセスできるキーと値のペア
  • 必要なプロパティ: サービスによって更新され、デバイスによって受信されます
  • 報告されたプロパティ: デバイスによって更新され、サービスによって受信されます。

可能性はありますが、必要なプロパティと報告されるプロパティは一致する必要はありません。また、必要に応じて、これら 2 つのコレクションを同期するロジックが SDK のユーザーに任されていることに注意してください。

詳細については、「 デバイス ツインについて」を参照してください。

特定のデバイスの を取得 Twin する推奨される方法は、 メソッドを getTwin(string, HttpResponseCallback<Twin>) 使用することです。

コンストラクター

Twin(string | DeviceIdentity, Registry)

新しい Twin をインスタンス化します。 新しい Twin オブジェクトを取得するには、 メソッドを使用 getTwin(string, HttpResponseCallback<Twin>) することをお勧めします。

プロパティ

deviceId

ツインに関連付けられているデバイス ID の一意識別子 。デバイス ID レジストリに存在します。

etag

デバイス ツインの複数の並列エディションを回避するために、オプティミスティック コンカレンシーで使用されるタグ。

modelId

ツインに関連付けられているデバイス ID のモデル ID 。デバイス ID レジストリに存在します。

moduleId

デバイス ID レジストリに存在するツインに関連付けられているモジュールのモジュール識別子。

properties

必要なプロパティと報告されたプロパティの二次性 (それぞれ および properties.reported)。properties.desired

tags

サービス側でのみ使用でき、特定のデバイスを検索するためのクエリで使用できるキーと値のペアのコレクション。

メソッド

get()
get(IncomingMessageCallback<Twin>)

IoT Hub サービスからこのデバイス ツインの最新バージョンを取得します。

toJSON()
update(any)
update(any, IncomingMessageCallback<Twin>)

引数として指定されたパッチを使用して、デバイス ツインを更新します。

コンストラクターの詳細

Twin(string | DeviceIdentity, Registry)

新しい Twin をインスタンス化します。 新しい Twin オブジェクトを取得するには、 メソッドを使用 getTwin(string, HttpResponseCallback<Twin>) することをお勧めします。

new Twin(device: string | DeviceIdentity, registryClient: Registry)

パラメーター

device

string | DeviceIdentity

デバイス識別子文字列、またはデバイスを記述するオブジェクト。 Object の場合は、deviceId プロパティを含む必要があります。

registryClient
Registry

REST API 呼び出しの実行に使用される HTTP レジストリ クライアント。

プロパティの詳細

deviceId

ツインに関連付けられているデバイス ID の一意識別子 。デバイス ID レジストリに存在します。

deviceId: string

プロパティ値

string

etag

デバイス ツインの複数の並列エディションを回避するために、オプティミスティック コンカレンシーで使用されるタグ。

etag: string

プロパティ値

string

modelId

ツインに関連付けられているデバイス ID のモデル ID 。デバイス ID レジストリに存在します。

modelId?: string

プロパティ値

string

moduleId

デバイス ID レジストリに存在するツインに関連付けられているモジュールのモジュール識別子。

moduleId?: string

プロパティ値

string

properties

必要なプロパティと報告されたプロパティの二次性 (それぞれ および properties.reported)。properties.desired

properties: { desired: {[key: string]: any}, reported: {[key: string]: any} }

プロパティ値

{ desired: {[key: string]: any}, reported: {[key: string]: any} }

tags

サービス側でのみ使用でき、特定のデバイスを検索するためのクエリで使用できるキーと値のペアのコレクション。

tags: {[key: string]: string}

プロパティ値

{[key: string]: string}

メソッドの詳細

get()

function get(): Promise<ResultWithIncomingMessage<Twin>>

戻り値

Promise<ResultWithIncomingMessage<Twin>>

get(IncomingMessageCallback<Twin>)

IoT Hub サービスからこのデバイス ツインの最新バージョンを取得します。

function get(done?: IncomingMessageCallback<Twin>)

パラメーター

done

IncomingMessageCallback<Twin>

操作が完了したときに呼び出す省略可能な関数。 done は、Error オブジェクト (null を指定できます)、作成されたデバイス ID を表す Twin オブジェクト、およびログ記録またはデバッグに役立つトランスポート固有の応答オブジェクトの 3 つの引数で呼び出されます。

toJSON()

function toJSON(): object

戻り値

object

update(any)

function update(patch: any): Promise<ResultWithIncomingMessage<Twin>>

パラメーター

patch

any

戻り値

Promise<ResultWithIncomingMessage<Twin>>

update(any, IncomingMessageCallback<Twin>)

引数として指定されたパッチを使用して、デバイス ツインを更新します。

function update(patch: any, done?: IncomingMessageCallback<Twin>)

パラメーター

patch

any

このデバイス ツインに適用する新しい値を含む オブジェクト。

done

IncomingMessageCallback<Twin>

操作が完了したときに呼び出す省略可能な関数。 done は、Error オブジェクト (null を指定できます)、作成されたデバイス ID を表す Twin オブジェクト、およびログ記録またはデバッグに役立つトランスポート固有の応答オブジェクトの 3 つの引数で呼び出されます。