فئة GNSPermission

مرجع فئة GNSPermission

نظرة عامة

يتيح لك هذا الصف إدارة حالة إذن "الأجهزة المجاورة" للتطبيق على الجهاز الحالي.

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

ننصح بأن يوفّر تطبيقك للمستخدم طريقة لتفعيل الأذونات أو إيقافها، على سبيل المثال، باستخدام مفتاح تبديل في صفحة الإعدادات. عندما يفعِّل المستخدم الخيار، يجب أن يطلب التطبيق تنفيذ الإجراءَين isGranted وsetGranted أدناه لتبديل حالة الإذن.

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

تكتسب NSObject.

ملخّص طريقة المثيل

(instancetype) - initWithChangedHandler:
 تعمل هذه السياسة على إعداد كائن الإذن باستخدام معالج يتم استدعاؤه في حال تغيّرت حالة الإذن. المزيد...
 

ملخّص طريقة الفئة

(BOOL) + isGranted
 ما إذا تم منح إذن "الأجهزة المجاورة" حاليًا للتطبيق على هذا الجهاز أم لا. المزيد...
 
(void) + setGranted:
 تغيير حالة إذن "الأجهزة المجاورة" المزيد...
 

تفاصيل الطريقة

- (instancetype) initWithChangedHandler: (GNSPermissionHandler)  changedHandler

تعمل هذه السياسة على إعداد كائن الإذن باستخدام معالج يتم استدعاؤه في حال تغيّرت حالة الإذن.

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

Parameters
handlerThe permission granted handler
+ (BOOL) isGranted

ما إذا تم منح إذن "الأجهزة المجاورة" حاليًا للتطبيق على هذا الجهاز أم لا.

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

+ (void) setGranted: (BOOL)  granted

تغيير حالة إذن "الأجهزة المجاورة"

يجب طلب ذلك فقط استجابة لإجراء المستخدم المتمثل في تغيير حالة الإذن.