Message class

الحزمة:

azure-iot-common

Message يتم استخدام الكائن لبيانات تتبع الاستخدام (من جهاز إلى سحابة) والأوامر (من السحابة إلى الجهاز) المراسلة غير المتزامنة بين الجهاز وخدمة IoT Hub. إنه غير محدد للنقل، ما يعني أنه يعمل بنفس الطريقة عبر AMQP وMQTT وHTTP.

المنشئون

Message(BufferConvertible)

إنشاء كائن جديد Message

الخصائص

ack	نوع الملاحظات المطلوبة (في حالة الأمر من السحابة إلى الجهاز)
contentEncoding	ترميز المحتوى لنص الرسالة. يمكن أن يكون "utf-8" أو "utf-16" أو "utf-32".
contentType	خاصية نوع المحتوى المستخدمة في التوجيهات مع نص الرسالة. يجب أن يكون "application/json".
correlationId	يستخدم في استجابات الرسائل والملاحظات
data
expiryTimeUtc	وقت انتهاء الصلاحية في التوقيت العالمي المتفق عليه الذي تم تفسيره بواسطة المركز على رسائل C2D. تم تجاهله في حالات أخرى.
interfaceId	هل هذه الرسالة هي رسالة أمان
lockToken	يستخدم للتخلي عن الرسالة أو رفضها أو قبولها
messageId	يستخدم لربط الاتصال ثنائي الاتجاه. التنسيق: سلسلة حساسة لحالة الأحرف (يصل طولها إلى 128 حرفا) من الأحرف الأبجدية الرقمية من ASCII 7 بت والرموز الخاصة التالية: - : . + % _ # * ? ! ( ) , = @ ; $ '.
properties	خريطة تحتوي على مفاتيح سلسلة وقيم لتخزين خصائص الرسالة المخصصة.
to	وجهة الرسالة.
userId	يستخدم لتحديد الكيان الذي يقوم بإنشاء الرسالة

الأساليب

getBytes()	يحصل على البيانات التي تم تمريرها إلى الدالة الإنشائية كمخزن مؤقت
getData()	يحصل على محتوى (النص الأساسي) ل Message.
isBufferConvertible(any)	إرجاع true إذا كان الكائن المحدد من النوع BufferConvertible. يمكن تمرير العناصر من النوع BufferConvertible إلى منشئ الرسالة .
setAsSecurityMessage()	تعيين هذه الرسالة كرسالة أمان

تفاصيل المنشئ

Message(BufferConvertible)

إنشاء كائن جديد Message

new Message(data: BufferConvertible)

المعلمات

data

BufferConvertible

كائن Node Buffer أو أي شيء يمكن تمريره إلى منشئ المخزن المؤقت لإنشاء مخزن مؤقت منه.

تفاصيل الخاصية

ack

نوع الملاحظات المطلوبة (في حالة الأمر من السحابة إلى الجهاز)

ack: string

قيمة الخاصية

string

contentEncoding

ترميز المحتوى لنص الرسالة. يمكن أن يكون "utf-8" أو "utf-16" أو "utf-32".

contentEncoding: undefined | "utf-8" | "utf-16" | "utf-32"

قيمة الخاصية

undefined | "utf-8" | "utf-16" | "utf-32"

contentType

خاصية نوع المحتوى المستخدمة في التوجيهات مع نص الرسالة. يجب أن يكون "application/json".

contentType: undefined | "application/json"

قيمة الخاصية

undefined | "application/json"

correlationId

يستخدم في استجابات الرسائل والملاحظات

correlationId: string

قيمة الخاصية

string

data

data: any

قيمة الخاصية

any

expiryTimeUtc

وقت انتهاء الصلاحية في التوقيت العالمي المتفق عليه الذي تم تفسيره بواسطة المركز على رسائل C2D. تم تجاهله في حالات أخرى.

expiryTimeUtc: any

قيمة الخاصية

any

interfaceId

هل هذه الرسالة هي رسالة أمان

interfaceId: string

قيمة الخاصية

string

lockToken

يستخدم للتخلي عن الرسالة أو رفضها أو قبولها

lockToken: string

قيمة الخاصية

string

messageId

يستخدم لربط الاتصال ثنائي الاتجاه. التنسيق: سلسلة حساسة لحالة الأحرف (يصل طولها إلى 128 حرفا) من الأحرف الأبجدية الرقمية من ASCII 7 بت والرموز الخاصة التالية:
- : . + % _ # * ? ! ( ) , = @ ; $ '.

messageId: string

قيمة الخاصية

string

properties

خريطة تحتوي على مفاتيح سلسلة وقيم لتخزين خصائص الرسالة المخصصة.

properties: Properties

قيمة الخاصية

Properties

to

وجهة الرسالة.

to: string

قيمة الخاصية

string

userId

يستخدم لتحديد الكيان الذي يقوم بإنشاء الرسالة

userId: string

قيمة الخاصية

string

تفاصيل الأسلوب

getBytes()

يحصل على البيانات التي تم تمريرها إلى الدالة الإنشائية كمخزن مؤقت

function getBytes(): Buffer

المرتجعات

Buffer

getData()

يحصل على محتوى (النص الأساسي) ل Message.

function getData(): BufferConvertible

المرتجعات

BufferConvertible

محتوى Message.

isBufferConvertible(any)

إرجاع true إذا كان الكائن المحدد من النوع BufferConvertible. يمكن تمرير العناصر من النوع BufferConvertible إلى منشئ الرسالة .

static function isBufferConvertible(obj: any): boolean

المعلمات

obj

any

مثيل الكائن للتحقق

المرتجعات

boolean

صحيح إذا كان الكائن من نوع BufferConvertible

setAsSecurityMessage()

تعيين هذه الرسالة كرسالة أمان

function setAsSecurityMessage()