تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

قائمة انتظار الرسائل السريعة باستخدام AIDL

اعتبارًا من Android 12، يمكن استخدام Fast Message Queue مع واجهات AIDL باستخدام الخلفية في NDK. يسمح هذا للعمليات والتواصل دون النفقات العامة والقيود المفروضة على معاملات الحافظ بعد الإعداد القصير. يتيح استخدام Stable AIDL التواصل بين عمليات النظام و المورّد.

أنواع الحمولات المسموح بها

أنواع parcelable في @FixedSize AIDL
نوعان (enum) من AIDL
أنواع تكامل AIDL

يجب أن تتضمّن الرسائل المُرسَلة بين العمليات في قائمة انتظار رسائل الذاكرة المشتركة تنسيق الذاكرة نفسه على مستوى حدود العمليات، ولا يمكن أن تحتوي على مؤشرات. سيؤدي محاولة إنشاء AidlMessageQueue بنوع غير متوافق إلى حدوث خطأ في الترجمة.

أنواع قوائم الانتظار المتوافقة

تتوفّر أنواع القوائم نفسها من HIDL، والتي يُشار إليها غالبًا باسم "النكهات"، مع AIDL. تستخدم هذه كوسيطات نموذج قوائم الانتظار والأوصاف.

أنواع HIDL	أنواع AIDL
`android::hardware::kSynchronizedReadWrite`	`android.hardware.common.fmq.SynchronizedReadWrite`
`android::hardware::kUnsynchronizedWrite`	`android.hardware.common.fmq.UnsynchronizedWrite`

كيفية الاستخدام

حدِّد واجهة AIDL التي ستُرسل MQDescriptor إلى العملية الأخرى. يمكن استخدام السمة MQDescriptor في أي مكان.

وسيطات النموذج المطلوبة لدالة MQDescriptor هي نوع الحمولة ونكهة "القائمة الانتظار".

import android.hardware.common.fmq.MQDescriptor
import android.hardware.common.fmq.SynchronizedReadWrite

void getQueue(out MQDescriptor<int, SynchronizedReadWrite> mqDesc);

إنّ عملية إعداد كل جانب من صف الرسائل متطابقة تقريبًا مع العملية باستخدام HIDL، باستخدام أنواع AIDL فقط.

#include <fmq/AidlMessageQueue.h>
...
using ::android::AidlMessageQueue;
using ::aidl::android::hardware::common::fmq::MQDescriptor;
using ::aidl::android::hardware::common::fmq::SynchronizedReadWrite;
...
ndk::ScopedAStatus MyInterface::getQueue(MQDescriptor<int32_t, SynchronizedReadWrite>* mqDesc) {
    *mqDesc = mFmqSynchronized->dupeDesc();
    return ndk::ScopedAStatus::ok();
}
...
// Create the first side of the queue before servicing getQueue() in this example
mFmqSynchronized =
  new AidlMessageQueue<int32_t, SynchronizedReadWrite>(kNumElementsInQueue);

ستنشئ عملية الاستقبال الجانب الآخر من "قائمة الانتظار" باستخدام الوصف الذي تم استلامه من واجهة AIDL.

MQDescriptor<int32_t, SynchronizedReadWrite> desc;
auto ret = service->getQueue(true, &desc);
if (!ret.isOk()) {
   ...
}
// By default the constructor will reset the read and write pointers of the queue.
// Add a second `false` argument to avoid resetting the pointers.
mQueue = new (std::nothrow) AidlMessageQueue<int32_t, SynchronizedReadWrite>(desc);
if (!mQueue->isValid()) {
   ...
}

يُرجى العِلم أنّ استخدام AidlMessageQueue بعد الإعداد هو نفسه استخدام HIDL MessageQueue. جميع واجهات برمجة التطبيقات الموضحة في استخدام قائمة انتظار الرسائل متوافقة بالكامل مع AidlMessageQueue مع استثناء واحد:

تم استبدال const MQDescriptor<T, flavor>* getDesc() بـ MQDescriptor<T, U> dupeDesc() التي تعرض معيار AIDL MQDescriptor