الفرق بين المراجعتين ل"Cordova/cordova plugin vibration"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:إضافة التحكم بالاهتزاز في كوردوفا}}</noinclude> تصنيف: Cordova تصنيف: Plugin هذه الإ...')
 
(تحديث)
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:إضافة التحكم بالاهتزاز في كوردوفا}}</noinclude>
 
<noinclude>{{DISPLAYTITLE:إضافة التحكم بالاهتزاز في كوردوفا}}</noinclude>
 
[[تصنيف: Cordova]]
 
[[تصنيف: Cordova]]
[[تصنيف: Plugin]]
+
[[تصنيف: Cordova Plugin]]
هذه الإضافة متوافقة مع مواصفات الاهتزاز.  
+
هذه الإضافة متوافقة مع [http://www.w3.org/TR/vibration/ مواصفات الاهتزاز] في W3، إذ توفر طريقة للتحكم في اهتزاز الجهاز.
  
توفر هذه اإضافة طريقة لاهتزاز الجهاز.  
+
تعرّف هذه الإضافة كائناتٍ عامة، من بينها الكائن <code>navigator.vibrate</code>.  
  
تعرّف هذه اإضافة كائنات عامة، من بينها الكائن <code>navigator.vibrate</code>.
+
على الرغم من أنّ هذه الكائنات موجودة في النطاق العام (global scope)، إلا أنّها لن تكون متاحة إلا بعد إطلاق الحدث <code>[[Cordova/events#deviceready|deviceready]]</code>.  
 
 
على الرغم من أنّ هذه الكائنات موجودة في النطاق العام (global scope)، إلا أنّها لن تكون متاحة إلا بعد إطلاق الحدث <code>deviceready</code>.  
 
 
<syntaxhighlight lang="javascript">document.addEventListener("deviceready", onDeviceReady, false);
 
<syntaxhighlight lang="javascript">document.addEventListener("deviceready", onDeviceReady, false);
 
function onDeviceReady() {
 
function onDeviceReady() {
سطر 14: سطر 12:
 
}‎</syntaxhighlight>  
 
}‎</syntaxhighlight>  
  
تنبيه: تقرير عن القضايا على [https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Vibration%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC Apache Cordova issue tracker]
+
== التثبيت ==
 +
يمكن تثبيت هذه الإضافة عبر الأمر التالي:<syntaxhighlight lang="shell">cordova plugin add cordova-plugin-vibration‎</syntaxhighlight>
  
=== التثبيت ===  
+
== المنصات المدعومة ==
<syntaxhighlight lang="javascript">cordova plugin add cordova-plugin-vibration‎</syntaxhighlight>
+
*[[Cordova/platforms android|أندرويد]]
 +
*[[Cordova/platforms ios|iOS]]
 +
*[[Cordova/platforms windows|ويندوز]]
  
=== المنصات المدعومة ===
+
يدعم [[Cordova/webviews|عارض]] أندرويد (ذو الواجهة البرمجية من المستوى 19 وما يليه) [https://www.w3.org/TR/vibration/ الواجهةَ البرمجية لمواصفات الاهتزاز من W3C] بشكل أصلي؛ وتبعًا لذلك، فقد تم تجاهل مواصفات التقديم (implementation) الخاص بأندرويد لهذه الإضافة.
  
navigator.vibrate  
+
==<code>vibrate</code>==
*أندرويد
 
*iOS
 
*ويندوز
 
  
يدعم [[Cordova/webviews|عارض]] أندرويد (الواحهة البرمجية من المستوى 19 وما يليه) [https://www.w3.org/TR/vibration/ W3C Vibration API] الأصلي، وتبعًا لذلك، فقد تم تجاوز مواصفات التقديم الخاصة بهذه الإضافة في أندرويد.
+
تقوم هذه الدالة بثلاث وظائف مختلفة، بناءً على المعاملات المُمرّرة إليها.
 +
=== الاهتزاز العادي (Standard vibrate) ===
  
===vibrate===
+
عند تمرير عددٍ أو مصفوفة تحتوي عددًا واحدًا غير معدومٍ إلى هذه الدالة، فسيهتز الجهاز للفترة التي يحددها ذلك العدد.
 +
<syntaxhighlight lang="javascript">navigator.vibrate(time)‎
 +
// أو
 +
navigator.vibrate([time])‎</syntaxhighlight>
  
تقوم هذه الدالةة بثلاث وظائف مختلفة، بناءً على المعاملات المُمرّرة إليها.  
+
يمثِّل المعامل <code>time</code> عدد صحيح أو مصفوفة تحدِّد مدة الاهتزاز بالميلي ثواني.  
==== الاهتزاز العادي (Standard vibrate) ====
 
  
في هذا الوضع يهتز الجهاز لفترة محددة من الوقت.
+
إليك المثال التالي:<syntaxhighlight lang="javascript">// الاهتزاز لثلاث ثواني
<syntaxhighlight lang="javascript">navigator.vibrate(time)‎</syntaxhighlight>
 
 
 
أو
 
<syntaxhighlight lang="javascript">navigator.vibrate([time])‎</syntaxhighlight>
 
 
 
-<code>time</code>: مدة الاهتزاز بالميليثواني. (عدد)
 
Example
 
<syntaxhighlight lang="javascript">// Vibrate for 3 seconds
 
 
navigator.vibrate(3000);
 
navigator.vibrate(3000);
// Vibrate for 3 seconds
+
// الاهتزاز لثلاث ثواني
 
navigator.vibrate([3000]);‎</syntaxhighlight>  
 
navigator.vibrate([3000]);‎</syntaxhighlight>  
 
====ملاحظات خاصة بمنصة أندرويد ====  
 
====ملاحظات خاصة بمنصة أندرويد ====  
  
استدعاء <code>navigator.vibrate</code> سيعيد فورًا القيمة <code>false</code> إذا لم ينقر المستخدم على الإطار (frame) أو أي إطار مضمن حتى الآن. يرجى مرجعة https://issues.apache.org/jira/browse/CB-14022 لمزيد من المعلومات.  
+
استدعاء <code>navigator.vibrate</code> سيعيد فورًا القيمة <code>false</code> إذا لم ينقر المستخدم على الإطار (frame) أو أي إطار مضمن خلال الاهتزاز. يرجى مراجعة هذه [https://issues.apache.org/jira/browse/CB-14022 الصفحة] لمزيد من المعلومات.
iOS Quirks
 
* <code>time</code>: تتجاهل منصة iOS الوقت المحدد، إذ يهتز الجهاز لمدة محددة مسبقًا.
 
  
navigator.vibrate (3000)؛ // يتم تجاهله 3000
+
==== ملاحظات خاصة بمنصة iOS ====
ملاحظات خاصة بويندوز
+
* تتجاهل منصة iOS الوقت المحدد عبر المعامل <code>time</code>، إذ يهتز الجهاز لمدة محددة مسبقًا.
* <code>time</code>: الحد الأقصى للمدة الزمنية هو 5000 ميليثواني (5 ثوانٍ)، والوقت الأدنى هو 1 ميلييثانية
+
<syntaxhighlight lang="javascript">navigator.vibrate (3000) // 3000  يتم تجاهله  </syntaxhighlight>
  
navigator.vibrate (8000)؛ // سيتم تحويلها إلى 5000
+
==== ملاحظات خاصة بويندوز ====
==== الاهتزاز وفق نمط (أندرويد وويندوز فقط) ====  
+
* الحد الأقصى للمدة الزمنية المحددة باستعمال المعامل <code>time</code> هو 5000 ميلي ثانية (5 ثوانٍ)، والحد الأدنى هو 1 ميلي ثانية
 +
<syntaxhighlight lang="javascript">navigator.vibrate (8000) // 5000 سيتم تحويلها إلى   </syntaxhighlight>
 +
=== الاهتزاز وفق نمط معين (أندرويد وويندوز فقط) ===  
  
يهتز الجهاز وفق نمط معين  
+
عند تمرير مصفوفة غير أحادية، فسيهتز الجهاز وفق نمط معين.
<syntaxhighlight lang="javascript">navigator.vibrate(pattern);‎</syntaxhighlight>  
+
<syntaxhighlight lang="javascript">navigator.vibrate(pattern);‎</syntaxhighlight>يمثِّل المعامل <code>pattern</code> مصفوفة من الأعداد تحوي تسلسلًا من الفترات الزمنية (بالميلي ثانية) لتشغيل الاهتزاز أو إيقافه.
* <code>pattern</code>: تسلسل من المُدَدِ الزمنية (بالميليثانية) لتشغيل الاهتزاز أو توقيفه. (مصفوفة من الأعداد)
+
 
مثال
+
اطلع على المثال التالي الذي يشرح ما سبق:<syntaxhighlight lang="javascript">// الاهتزاز لثانية واحدة
<syntaxhighlight lang="javascript">// Vibrate for 1 second
+
// ثم الانتظار ثانية واحدة
// Wait for 1 second
+
// ثم الاهتزاز ثلاث ثوانٍ
// Vibrate for 3 seconds
+
// ثم الانتظار ثانية واحدة
// Wait for 1 second
+
// ثم الاهتزاز لخمس ثوانٍ
// Vibrate for 5 seconds
 
 
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);‎</syntaxhighlight>  
 
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);‎</syntaxhighlight>  
==== إلغاء الاهتزاز (غير مدعوم في منصة iOS) ====
+
=== إلغاء الاهتزاز (غير مدعوم في منصة iOS) ===  
 
 
لإلغاء أيّ اهتزاز حاليً على الفور، مرر الصفر إلى التابع.
 
<syntaxhighlight lang="javascript">navigator.vibrate(0)‎</syntaxhighlight>
 
  
أو  
+
للإلغاء الفوري لأيّ اهتزاز حاليً، مرر الصفر، أو مصفوفة تحتوي على الصفر فقط، أو مصفوفة فارغة إلى التابع <code>vibrate</code>.
<syntaxhighlight lang="javascript">navigator.vibrate([])</syntaxhighlight>  
+
<syntaxhighlight lang="javascript">navigator.vibrate(0)‎
 +
// أو
 +
navigator.vibrate([])
 +
// أو
 +
navigator.vibrate([0])</syntaxhighlight>سيؤدي تمرير  القيمة <code>0</code>، أو مصفوفة فارغة، أو مصفوفة أحادية تحتوي <code>0</code> إلى إلغاء الاهتزازات.
  
أو
+
== انظر أيضًا ==
<syntaxhighlight lang="javascript">navigator.vibrate([0])‎</syntaxhighlight>
+
* إضافة <nowiki/>[[Cordova/cordova plugin battery status|حالة البطارية]]
 +
* إضافة [[Cordova/cordova plugin device|حالة الجهاز]]
 +
* [[Cordova/plugins|دليل تطوير الإضافات في كوردوفا]]
  
سيؤدي تمرير القيمة 0، أو مصفوفة فارغة، أو مصفوفة تحتوي على عنصر واحد يساوي 0، إلى إلغاء أي اهتزازات.
 
 
==مصادر==
 
==مصادر==
 
*[https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-vibration/index.html صفحة cordova-plugin-vibration في توثيق كوردوفا الرسمي.]
 
*[https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-vibration/index.html صفحة cordova-plugin-vibration في توثيق كوردوفا الرسمي.]

المراجعة الحالية بتاريخ 22:23، 3 ديسمبر 2020

هذه الإضافة متوافقة مع مواصفات الاهتزاز في W3، إذ توفر طريقة للتحكم في اهتزاز الجهاز.

تعرّف هذه الإضافة كائناتٍ عامة، من بينها الكائن navigator.vibrate.

على الرغم من أنّ هذه الكائنات موجودة في النطاق العام (global scope)، إلا أنّها لن تكون متاحة إلا بعد إطلاق الحدث deviceready.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.vibrate);
}

التثبيت

يمكن تثبيت هذه الإضافة عبر الأمر التالي:

cordova plugin add cordova-plugin-vibration‎

المنصات المدعومة

يدعم عارض أندرويد (ذو الواجهة البرمجية من المستوى 19 وما يليه) الواجهةَ البرمجية لمواصفات الاهتزاز من W3C بشكل أصلي؛ وتبعًا لذلك، فقد تم تجاهل مواصفات التقديم (implementation) الخاص بأندرويد لهذه الإضافة.

vibrate

تقوم هذه الدالة بثلاث وظائف مختلفة، بناءً على المعاملات المُمرّرة إليها.

الاهتزاز العادي (Standard vibrate)

عند تمرير عددٍ أو مصفوفة تحتوي عددًا واحدًا غير معدومٍ إلى هذه الدالة، فسيهتز الجهاز للفترة التي يحددها ذلك العدد.

navigator.vibrate(time)
// أو
navigator.vibrate([time])

يمثِّل المعامل time عدد صحيح أو مصفوفة تحدِّد مدة الاهتزاز بالميلي ثواني.

إليك المثال التالي:

// الاهتزاز لثلاث ثواني
navigator.vibrate(3000);
// الاهتزاز لثلاث ثواني
navigator.vibrate([3000]);

ملاحظات خاصة بمنصة أندرويد

استدعاء navigator.vibrate سيعيد فورًا القيمة false إذا لم ينقر المستخدم على الإطار (frame) أو أي إطار مضمن خلال الاهتزاز. يرجى مراجعة هذه الصفحة لمزيد من المعلومات.

ملاحظات خاصة بمنصة iOS

  • تتجاهل منصة iOS الوقت المحدد عبر المعامل time، إذ يهتز الجهاز لمدة محددة مسبقًا.
navigator.vibrate (3000)  // 3000  يتم تجاهله

ملاحظات خاصة بويندوز

  • الحد الأقصى للمدة الزمنية المحددة باستعمال المعامل time هو 5000 ميلي ثانية (5 ثوانٍ)، والحد الأدنى هو 1 ميلي ثانية
navigator.vibrate (8000)  // 5000 سيتم تحويلها إلى

الاهتزاز وفق نمط معين (أندرويد وويندوز فقط)

عند تمرير مصفوفة غير أحادية، فسيهتز الجهاز وفق نمط معين.

navigator.vibrate(pattern);

يمثِّل المعامل pattern مصفوفة من الأعداد تحوي تسلسلًا من الفترات الزمنية (بالميلي ثانية) لتشغيل الاهتزاز أو إيقافه. اطلع على المثال التالي الذي يشرح ما سبق:

// الاهتزاز لثانية واحدة
// ثم الانتظار ثانية واحدة
// ثم الاهتزاز ثلاث ثوانٍ
// ثم الانتظار ثانية واحدة
// ثم الاهتزاز لخمس ثوانٍ
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);

إلغاء الاهتزاز (غير مدعوم في منصة iOS)

للإلغاء الفوري لأيّ اهتزاز حاليً، مرر الصفر، أو مصفوفة تحتوي على الصفر فقط، أو مصفوفة فارغة إلى التابع vibrate.

navigator.vibrate(0)
// أو
navigator.vibrate([])
// أو
navigator.vibrate([0])

سيؤدي تمرير القيمة 0، أو مصفوفة فارغة، أو مصفوفة أحادية تحتوي 0 إلى إلغاء الاهتزازات.

انظر أيضًا

مصادر