Table of Contents

فهم دور الحركة الأساسية في تتبع الخطوات

ويشكل إطار العمل الأساسي للتحرك الأساسي للتشغيل المكثف المكثف، وملامح التتبع المكثف للبطارية في تطبيقات اللياقة الكهربائية، حيث يتيح للمطورين التركيز على خبرة المستعملين بدلا من تجهيز الإشارات المنخفضة المستوى، وتعقيدات بيانات الاستشعار الخام من مطياف التسارع، والقنوات، والمقاس، والمقاس، والمقياس، والمقياس المرجعي، والمقياس المرجعي الأساسي، ويعطي تقديرا موحدا لنشاط المطورين.

At the heart of step tracking is the CMPedometer class, which exposes step count, distance, pace, and cadence data without requiring developers to directly interpret accelerometer waveforms. This streamlines implementation and ensures consistency across different iPhone and Apple Watch models. whether you are building a dedicated step-racking appor or add activity monitoring to

العناصر الأساسية لتتبع الخطوات والنشاط

مؤتمر الأطراف/اجتماع الأطراف - مسار الخطوة الأولى

The CMPedometer class is the go‐to component for obtaining step data in iOS apps. It provides both live updates and historical query capabilities. Key properties of include , , ,

وقبل استخدام مقياس مؤتمر الأطراف/اجتماع الأطراف، يجب أن تتحققوا من مدى توافر . وفي حين أن جميع أجهزة الإيوس الحديثة تقريباً تدعم إحصاء درجاتها، فإن النماذج القديمة أو مشاهد آبل قد تعود دون مقياس مبني .() وسيعالج التنفيذ القوي هذه الحالات بشكل جيد وسيوفر تراجعاً مناسباً أو يبطل السمة.

CMMotionManager - Raw Sensor Access for Advanced Use Cases

وفي حين أن مقياس مؤتمر الأطراف/اجتماع الأطراف كافٍ لمعظم احتياجات التتبع التدريجي، فإن CMManager] يتيح للمطورين إمكانية الوصول إلى مطياف الجهاز، والقنوات، والمغنطيس، ويمكن أن يكون ذلك مفيداً لمقياس قياس درجة قياسية، وتحليلات مكملة غير عادية، أو عندما تحتاج إلى الجمع بين بيانات المقياس والموجات المتحركة باستمرار.

ملاحظة أن حركة الحركة لا تقوم تلقائياً بحساب الخطوات؛ ويجب أن تنفذوا تصفية طاقتكم الخاصة وتحسبوا المنطق باستخدام قيم التسارع الخام، وهذا النهج أكثر تعقيداً وعادة ما يكون مبرراً إلا إذا احتجتم إلى معالجة الحساسية أو كشف الخطوات في السيناريوهات غير المتحركة (مثل استخدام الكراسي المتحركة).

Deprecation of CMStepCounter and Migration

(أ) في وقت سابق من مراحل التوقيف المسبق المستخدم لتتبع الخطى، ولكن هذه الفئة قد استُهلاكت في محطة iOS 13. All new development should use CMPedometer exclusively.() وإذا احتفظت برمز الإرث، فإن الهجرة تنطوي على استبدال المكالمات مع ما يعادل .

تنفيذ مسار العمل

التحقق من مدى توافر الانبعاثات وطلبها

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

(ب) إن خصوصية المستعمل بالغة الأهمية: فالحركة الأساسية تطلب تلقائياً إذناً من المستخدم في المرة الأولى التي يحاول فيها طلب الحصول على بيانات التماسات، ويجب أن تُدرج مفتاح في ملفك ]، مع تقديم شرح موجز لما يحتاج إليه طلبكم من بيانات، وبدون هذا المفتاح، سيحرم النظام من الوصول إليه، كما أن اتصالاتكم ستفشل في عملية الإدماج في السجل الصحي (انظر القسم الرئيسي في وقت لاحق)().

بدء تحديثات المقاييس في الزمن الحقيقي

(ج) تلقي تحديثات خطية حية، الاتصال [(FLT:21]) ونموذج هو عادة التاريخ والزمان الحاليين، ويُحتج بمبنى المعالج في كل مرة تتوافر فيها بيانات خطية جديدة، وداخل المعالج، يفحص دائماً الأخطاء أولاً - مثلاً، إذا رفض المستخدم الإذن، فإن الخطأ سيتضمن أو ما شابه ذلك.

ومن النمط المشترك إنشاء حالة كملكية لمراقبي وجهة نظركم أو لفئة المديرين، والبدء في تحديث المعلومات عندما تظهر الشاشة ذات الصلة، على سبيل المثال:

let pedometer = CMPedometer()
pedometer.startUpdates(from: Date()) { (data, error) in
 guard let data = data, error == nil else { return }
 DispatchQueue.main.async {
 self.stepCountLabel.text = "\(data.numberOfSteps) steps"
 }
}

فالتحديثات في الوقت الحقيقي هي مثالية لبناء مقابر خطية حية أو الاندماج في دورات التمرين، ولكن يمكن أن تكون متقلبة في حالة تركها تعمل إلى أجل غير مسمى، تأكد من التوقف عن التحديثات عندما يبتعد المستخدم عن وجهة نظر التتبع أو عندما يدخل الطبق إلى الخلفية (ما لم تكن لديك القدرة على المعلومات الأساسية).

بيانات الخطوة التاريخية

وبالإضافة إلى التحديثات الحية، يمكن أن يسترد مقياس مؤتمر الأطراف/اجتماع الأطراف أرقاماً خطية لأي مدى زمني باستخدام [(FLT:27]) وهذا مفيد لعرض ملخصات يومية أو أسبوعية أو شهرية، ويسير الاستفسار في تزامن مع ذلك ويعيد البيانات الإجمالية عن الفترة المحددة، ويلاحظ أن النظام قد يحد من حجم البيانات التاريخية، ولا سيما بالنسبة للتواريخ البعيدة التي يمكن أن تكون فيها الممتلكات غير صالحة للاستمرار.

لتجنب اختناقات الأداء، تحد الاستفسارات إلى نوافذ زمنية معقولة (مثلاً، لا أكثر من أسبوع في كل مرة) وتخفي النتائج إذا كان تطبيقك يُظهر كثيراً مخططات تاريخية، ويمكنك أيضاً الجمع بين الاستفسارات عن الحركة الأساسية وبين قراءة " صحة كيت " من أجل صورة أكمل.

وقف تحديثات لبطارية الحفظ

(د) أن تدعو دائماً إلى حالة مقياسك عندما لا تحتاج إلى بيانات حية، وعدم التوقف عن التحديثات يمكن أن يستنفد البطارية ويفضي إلى شكاوى المستخدمين، وأن يربط دورة الحياة المستكملة بنظرة متحكمك في النظريات طرق التفكيك أو التفكيك، أما بالنسبة للمصابيح التي تتطلب التتبع المستمر في الخلفية (مثلاً، مركباً في الهواء) فيمكن [الملاحظة: 29]

معالجة قضايا الإغراق والادج

مقياس التوافق والتقدير

ليس لدى أجهزة الإيوس جميع قدرات الاستشعار ذات الحركة، أيفون 5ز، ثم بعد ذلك تشمل مجهزاً للحركة التلقائية للحركة التجميلية التي تفرغ حسابات المقاييس من وحدة العناية الفلكية الرئيسية، ولكن السلوك الدقيق يمكن أن يختلف، فعلى سبيل المثال، يدعم جهاز إيفون (الجيل الأول) عدّ الخطوة، بينما لا يُفحص دائماً مدى توافر واختبار الأسر المتعددة الأجهزة.

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

إدارة عمليات التداخل والمعلومات الأساسية

إذا كان تطبيقك في الخلفية، يمكن للحركة الأساسية أن توقف مؤقتاً تحديث المعلومات، وعند الاستدلال، ستحتاج إلى إعادة تحديث المقياس، وبغية توفير تجربة لا تحصى، والاستفسار عن آخر نقطة بيانات معروفة من مؤخر أنقذ قبل انقطاعه، ودعوة ] إلى سد الفجوة، وهذا النهج يضمن عدم فقدان أي خطوات أثناء وجوده قيد التشغيل.

وبالنسبة إلى تطبيقات المراقبة، فإن البيانات المتعلقة بالمسدسات المتزامنة تتزامن تلقائياً عن طريق جهاز التكتل لحركة آبل واتش، ولكن تطبيق نظام المراقبة الخاص بك يجب أن يتساءل صراحة عن مقياس الجهاز نفسه - وهو لا يتلقى تلقائياً خطوات مسجلة على الساعة، فتكامل الخيوط الصحي (مناقشة فيما بعد) يحل مشكلة التوازج هذه.

أفضل الممارسات في الأداء والخصوصية

تحقيق الحد الأمثل من أعمال البطارية وتجهيز النفقات العامة

وللحد من استنزاف البطاريات، اتبع هذه المبادئ التوجيهية:

  • Use CMPedometer] instead of CMMotionManager for step counting; the pedometer is equipment‐optimized.
  • لا تبدأ في التحديث إلا عندما يسمح المستخدم صراحةً بتتبع الخطوة أو يبدأ العمل
  • توقف عن التحديثات فور إختفاء شاشة التتبع أو انتهاء التمرين
  • وبغية عد الخطوات السلبية )مثلا، المجموع الكلي للخطوات الدائمة(، النظر في استخدام نظام " الصحة " لقراءة الخطوات التي يسجلها النظام - فإن مقياس النظام الخاص به يعمل بكفاءة في الخلفية.
  • Cache historical data locally to avoid repeated queries over the same time ranges.

الامتثال والتعامل مع البيانات

وتعتبر البيانات المتعلقة بخطوة المعلومات الصحية الحساسة، وينفذ التطبيق قواعد صارمة بشأن الخصوصية:

  • دائماً ما يشمل الخيط ؛ وعدم القيام بذلك يجعل رقم الأذن لا يظهر.
  • لا تتقاسم أبداً بيانات خطية مع محللين أو شبكات إعلانات طرف ثالث دون موافقة واضحة من المستعملين.
  • إذا قمت بتخزين بيانات خطية على خادم، فشفتها في العبور وفي الراحة، ووفرت وسيلة للمستعملين لحذف بياناتهم.
  • احترام قرار المستخدم بإلغاء الإذن؛ وينبغي أن يعالج تطبيقكم الخطأ بشكل معقول ومميزات تتبع خطوات غير قابلة للانتقاص.

إدماج صحة التفاح عن طريق الصحة

القراءة والكتابة

ولحل شامل لللياقة، يجمع بين الحركة الأساسية و]HalthKit.() وبينما يوفر الحركات الأساسية بيانات آنية، فإن شركة HealthKit تعمل بمثابة مستودع مركزي لجميع القياسات الصحية، ويمكنك قراءة عدادات الخطوات التي كتبها جهاز آخر أو النظام نفسه، ويمكنك كتابة بيانات خطوتك الخاصة إلى نظام الصحة كيت لتبادل المعلومات الصحية.

To write steps, create an of type and save it using . always request the authorization by calling near launch. Be aware that both Core Motion and HealthKit permissions must be granted separately.

ترجمة

ويمكن أن تستخدموا، عند قراءة الخطوات التاريخية، ] لموجز الخطوات على مدى فترة من الزمن، ويمكن أن يكون ذلك بمثابة تراجع إذا فشلت الاستفسارات عن مقياس مؤتمر الأطراف/اجتماع الأطراف أو إذا أردتم الجمع بين بيانات الخطوة من مرصد آبل، وتجنباً للازدواجية في الحسابات، واعتماد استراتيجية: إما الاعتماد على المقياس الأساسي للتخزين الحقيقي والصحي، أو على الدوام من نظام الصحة.

التحسينات المتقدمة في مسار الخطوة

تصنيف النشاط مع الحركة الأساسية

ويمكن للحركة الأساسية ][ أن تصنف حالة الطلب الحالي للمستعمل - مثل الحالة الثابتة أو المشي أو التشغيل أو التدوير أو القيادة، وتجميع هذه البيانات مع بيانات الخطوة يسمح بعرض التعليقات على السياق، مثل " كنت تمشي لمدة عشر دقائق " مقابل " ما زلت تدوير " .

قياسات تحديد الأسعار والرسوم من بيانات قياسات المقاييس

وتوفِّر و] الممتلكات في ] مقاييس سير أو تشغيل فورية، وتقدر المساحة في ثوان لكل متر، والسبب هو عدد الخطوات في الثانية، وهذه القيم مفيدة لبناء لوحات سطو تبين كثافة التشغيل الحالية للمستعمل، وتشير إلى أن هذه الممتلكات قد تكون ضئيلة عندما لا يمكن للجهاز تقديرها بصورة مباشرة.

بيانات التسارع المدمجة لخط التكافل

وإذا وجدتم أن مرشحات مقياس مؤتمر الأطراف/اجتماع الأطراف المبنية تفوت خطوات خلال أنشطة معينة )مثل تسلق السلالم مع السكك الحديدية(، يمكنكم استكمالها ببيانات التسارع الخام من ](FLT:44[. غير أن تطبيق مقياس للكشف بسيط يستخدم مقياسا منخفضا على حجم التسارع ومتوسطا للفحص الدقيق.

الاعتبارات والاختبارات العالمية الحقيقية

اختبارات على نماذج مختلفة من طراز iPhone وIOS Versions

سلوك التتبع يمكن أن يختلف عبر الأجهزة اختبار تطبيقك على الأقل هذه التشكيلات

  • IPhone 6s or older (without M9 coprocessor? actually all iPhones 5s and later have motion coprocessors, but older ones may have less precise data).
  • iPhone 8 or later (newer coprocessors).
  • iPhone with iOS 13+ (ensures latest API).
  • (بعض نماذج iPad تحتوي على مقاييس، ولكن الكثير منها لا يملكها).

استخدام الائتلاف على التليفزيوني لتسجيل رسائل الخطأ والتحقق من أن عمليات التفتيش التي توفرها تعمل بشكل صحيح، والنظر في استخدام مشية اختبارية قائمة على المعدات (مثلا 100 خطوة تم عدها يدويا) للتحقق من ناتج تطبيقك.

تقييم الخطوة الكونت Accuracy

ولا يوجد مقياس دقيق بنسبة 100 في المائة، ولوضع توقعات المستعملين، نشر نطاق دقيق نموذجي (مثلا " تتفاوت الدقة بالجهاز، ولكن الخطأ النموذجي في حدود 5 في المائة " )، وأثناء التنمية، مقارنة عدد خطوات تطبيقك بمقياس خط الأساس المعروف مثل تطبيق الصحة المبني، وفيما يتعلق باختبار التراجع، والسير الآلي مع طاولة هز (إن توفر) أو استخدام تسلسلات الاختبار اليدوية.

بناء مُتجر إنتاجي مع حركة أساسية

(أ) أن تتبع الخطوة مع الحركة الأساسية عملية مباشرة عندما تتبع المبادئ التوجيهية لـ " آبل " ، بدءاً من [(FLT:0]] مقياس بالنسبة لعدادات الخطوات، تضاف [(FLT:2]] [معنى اختبارات الاستخدام بالنسبة للسياق، مع [النسخة الكاملة] [النسخة المتزامنة]([5])

وللحصول على مزيد من القراءة، يرجى الرجوع إلى الوثائق الرسمية لأبل:

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