مشاركة عبر

عنصر تحكم الميكروفون في Power Apps

  • مقالة

عنصر تحكم يسمح لمستخدمي التطبيق بتسجيل الأصوات من جهازهم.

‏‏الوصف

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

يتوفر أحدث مقطع صوتي مسجل من خلال الخاصية الصوت. وباستخدام هذه الخاصية، يمكنك تنفيذ ما يلي على الصوت المسجل:

  • تشغيله مع عنصر تحكم الصوت. استخدم عنصر تحكم الصوت للاستماع إلى التسجيل. لمزيد من المعلومات، راجع الأمثلة.
  • وضعه بشكل مؤقت في متغير أو مجموعة. استخدم الدالة Set أو Collect لتخزين مقاطع الصوت في متغير أو مجموعة. يجب توخي الحذر عند وضع عدة مقاطع في مجموعة في الوقت نفسه عندما تكون ذاكرة الجهاز محدودة. استخدم الدالتين SaveData وLoadData لنقل مقاطع الصوت إلى مساحة التخزين المحلية على الجهاز ولتنفيذ سيناريوهات دون اتصال.
  • تخزينه في قاعدة بيانات. استخدم الدالة Patch لتخزين مقاطع الصوت في قاعدة بيانات.
  • إرساله كسلسلة نصية مرمزة بواسطة base64. استخدم الدالة JSON لترميز مقاطع الصوت بواسطة base64.

تنسيق الصوت المسجل:

  • تنسيق 3gp في نظام Android.
  • تنسيق AAC في نظام iOS.
  • تنسيق OGG في مستعرضات الويب.

يُشار إلى الوسائط الملتقطة بواسطة URI سلسلة نصية. لمزيد من المعلومات، راجع وثائق أنواع البيانات.

ملاحظة

يكون عنصر تحكم الميكروفون مدعومًا فقط في Microsoft Edge علي أساس ‏‫المستعرضات Chromium وChrome وFirefox ؛ وأجهزة Android وiOS. ستظهر كافة المستعرضات والمنصات الأخرى تحذيرًا بعدم عمل بعض ميزات التطبيق.

الخصائص الرئيسية

الصوت – مقطع الصوت الملتقط عندما يقوم المستخدم بالتسجيل باستخدام ميكروفون الجهام.

Mic – المعرف الرقمي لميكرفون على جهاز يحتوي على أكثر من ميكروفون واحد.

OnStop – إجراءات يتم تنفيذها عند توقف المستخدم عن التسجيل باستخدام عنصر تحكم الميكروفون.

خصائص إضافية

AccessibleLabel – تسمية لقارئات الشاشة. يجب أن تصف الغرض من الميكروفون.

BorderColor – لون حدود عنصر التحكم.

BorderStyle – عندما يكون حد عنصر التحكم من النوع ثابت‬‏‫ أو متقطع‏‎ أو منقط‏‎ أو بلا‏‎.

BorderThickness – سُمك حد عنصر التحكم.

Color – لون النص في عنصر تحكم.

DisplayMode – ما إذا كان عنصر التحكم يسمح بإدخال المستخدم (تحرير‏‎)، أو يعرض البيانات فقط (عرض) أو هو معطّل (معطّل).

DisabledBorderColor – لون حد عنصر التحكم إذا تم تعيين خاصية DisplayMode لعنصر التحكم إلى معطّل.

DisabledColor – لون النص في عنصر التحكم إذا تم تعيين خاصية DisplayMode لعنصر التحكم إلى معطّل.

DisabledFill – لون خلفية عنصر التحكم إذا تم تعيين خاصية DisplayMode لعنصر التحكم إلى معطّل.

Fill – لون خلفية عنصر التحكم.

FocusedBorderColor – لون حد عنصر التحكم عندما يتم التركيز على حد عنصر التحكم.

FocusedBorderThickness – سماكة حد عنصر التحكم عندما يتم الترميز على عنصر التحكم.

Height – المسافة بين الحواف العليا والسفلى لعنصر التحكم.

HoverBorderColor – لون حد عنصر التحكم عندما يُبقي المستخدم مؤشر الماوس على عنصر التحكم هذا.

HoverColor – لون النص في عنصر التحكم عندما يُبقي المستخدم مؤشر الماوس عليه.

HoverFill – لون خلفية نص عنصر التحكم عندما يُبقي المستخدم مؤشر الماوس عليه.

الصورة – اسم الصورة التي تظهر في عنصر تحكم الصورة، أو الصوت، أو الميكروفون

ImagePosition – موضع (تعبئة أو ملاءمة أو تمديد أو تجانب أو توسيط) صورة في شاشة أو في عنصر تحكم إذا لم تكن لها نفس الحجم كصورة.

OnSelect – إجراءات يتم تنفيذها عند تحديد المستخدم عنصر تحكم.

OnStart – إجراءات يتم تنفيذها عند بدء المستخدم في التسجيل باستخدام عنصر تحكم الميكروفون.

PressedBorderColor – لون حد عنصر التحكم عندما يحدد المستخدم عنصر التحكم هذا.

PressedColor – لون النص في عنصر التحكم عندما يحدد المستخدم عنصر التحكم هذا.

PressedFill – لون خلفية عنصر التحكم عندما يحدد المستخدم عنصر التحكم هذا.

Reset – ما إذا كان عنصر التحكم يعود إلى قيمته الافتراضية.

TabIndex – ترتيب التنقل بواسطة لوحة المفاتيح مقارنةً مع عناصر التحكم الأخرى.

Tooltip – نص تفسيري يظهر عندما يقوم المستخدم بتمرير الماوس فوق عنصر تحكم.

Visible – ما إذا كان عنصر التحكم ظاهرًا أم مخفيًا.

Width – المسافة بين الحواف اليمنى واليسرى لعنصر التحكم.

X – المسافة بين الحافة اليسرى لعنصر التحكم والحافة اليسرى للحاوية الأصلية أو الشاشة.

Y – المسافة بين الحافة العليا لعنصر التحكم والحافة العليا للحاوية الأصلية أو الشاشة.

الأمثلة

تشغيل مباشر بسيط

في هذا المثال، سنقوم بتوصيل عنصر تحكم الميكروفون مباشرةً بعنصر تحكم الصوت للتشغيل الفوري:

  1. أضف عنصر تحكم الميكروفون إلى تطبيقك.

  2. اسمح للتطبيق باستخدام ميكروفون الجهاز إذا تمت مطالبتك بذلك.

  3. أضف عنصر تحكم الصوت إلى تطبيقك.

  4. عيّن خاصية الصوت لعناصر تحكم Media إلى الصيغة.

    Microphone1.Audio

    ملاحظة

    استبدل اسم عنصر تحكم الميكروفون بالاسم Microphone1 كما تقتضي الحاجة.

  5. عاين التطبيق.

  6. حدد عنصر تحكم الميكروفون لبدء التسجيل.

  7. تكلم لتسجيل الصوت.

  8. حدد عنصر تحكم الميكروفون مرة أخرى لإنهاء التسجيل.

  9. حدد عنصر تحكم الصوت للاستماع إلى التسجيل.

في هذا المثال، سنقوم بإنشاء معرض لمقاطع الصوت المخزنة في مجموعة والتي يمكن تحديدها بشكل فردي لتشغيلها:

  1. أضف عنصر تحكم الميكروفون.

  2. عيّن خاصية OnStop لعنصر التحكم هذا إلى الدالة Collect:

    Collect( MySounds, MyMic.Audio )

  3. أضف عنصر تحكم المعرض، وانقله إلى أسفل MyMic.

  4. عيّن الخاصية Items إلى المعرض لهذه الصيغة:

    MySounds

  5. في قالب عنصر تحكم Custom المعرض، أضف عنصر تحكم الصوت.

  6. عيّن خاصية Media لعناصر تحكم الصوت إلى هذه الصيغة.

    ThisItem.Url

  7. اضغط على F5 لمعاينة التطبيق.

  8. حدد MyMic لبدء التسجيل، ثم حدده مرة أخرى لإيقاف التسجيل.

  9. في عنصر تحكم المعرض، حدد زر التشغيل في عنصر تحكم الصوت لتشغيل التسجيل.

  10. أضف العدد الذي تريده من التسجيلات، ثم عد إلى مساحة العمل الافتراضية بالضغط على المفتاح Esc.

  11. (اختياري) في قالب عنصر تحكم المعرض، أضف عنصر تحكم الزر.

  12. عيِّن خاصية OnSelect لعنصر التحكم إلى هذه الصيغة:

    Remove( MySounds, ThisItem )

  13. اضغط F5، ثم أزل التسجيل عن طريق تحديد عنصر تحكم الزر المناظر.

استخدم الدالة SaveData لحفظ التسجيلات محليًا أو الدالة Patch لتحديث مصدر بيانات.

إرشادات إمكانية الوصول

تنطبق الإرشادات نفسها لعنصر تحكم الزر لأن الميكروفون هو فقط زر متخصص. يمكنك أيضًا أن تأخذ في الاعتبار:

بدائل الصوت

يمكنك إضافة نموذج إدخال بديل للمستخدمين الذين لديهم إعاقات في الكلام أو ليس لديهم ميكروفون. على سبيل المثال، إدخال النص للسماح للمستخدمين بإدخال النص.

تباين الألوان

دعم قارئ الشاشة

راجع أيضًا

قيود عناصر التحكم في Power Apps