רמת הרשאה של GNS

הפניה לסוג של GNSPermission

סקירה כללית

הכיתה הזו מאפשרת לנהל את מצב ההרשאה של האפליקציה בקרבת מקום במכשיר הנוכחי.

המשתמש חייב להעניק הרשאה כדי שפרסומים ומינויים יפעלו. בפעם הראשונה שהאפליקציה יוצרת אתר חדשות או מינוי, תיבת הדו-שיח של ההרשאה 'בקרבת מקום' מוצגת באופן אוטומטי, כך שיש למשתמש הזדמנות להביע הסכמה. אם המשתמש ידחה, תוצג התראה בכל פעם שייווצרו בהמשך פרסום או מינוי, ותיתנו לו הזדמנות נוספת להצטרף.

מומלץ שהאפליקציה תספק למשתמש שיטה להפעלה או להשבתה של ההרשאה. לדוגמה, באמצעות מתג בדף ההגדרות. כשהמשתמש מפעיל את האפשרות הזאת, האפליקציה צריכה להפעיל את השיטות isGranted ו-setGranted שמפורטות בהמשך כדי להחליף את מצב ההרשאה.

כדי לעקוב אחר מצב ההרשאה, צריך ליצור אובייקט GNSPermission ולהעביר ב-handler שהשתנה. ה-handler יופעל בכל פעם שמצב ההרשאה ישתנה, וכך ממשק המשתמש של האפליקציה יישאר מסונכרן עם המצב הנוכחי.

יורש את NSObject.

סיכום שיטות של מכונה

(instancetype) - initWithChangedHandler:
 מפעיל את אובייקט ההרשאה באמצעות handler שמופעל בכל פעם שמצב ההרשאה משתנה. עוד...
 

סיכום של שיטת כיתה

(BOOL) + isGranted
 אם ההרשאה 'בקרבת מקום' ניתנה כרגע לאפליקציה במכשיר הזה. עוד...
 
(void) + setGranted:
 משנה את מצב ההרשאה 'בקרבת מקום'. עוד...
 

פרטי השיטה

- (instancetype) initWithChangedHandler: (GNSPermissionHandler)  changedHandler

מפעיל את אובייקט ההרשאה באמצעות handler שמופעל בכל פעם שמצב ההרשאה משתנה.

ה-handler מאפשר לאפליקציה לסנכרן את ממשק המשתמש שלה עם מצב ההרשאה. ה-handler לא מופעל עד שהמשתמש מאשר או דחה את ההרשאה.

Parameters
handlerThe permission granted handler
+ (BOOL) isGranted

אם ההרשאה 'בקרבת מקום' ניתנה כרגע לאפליקציה במכשיר הזה.

'כן' פירושו שהמשתמש העניק הרשאה ל'בקרבת מקום', ו'לא' פירושו שהמשתמש דחה את ההרשאה. אם לא ניתנה הרשאה, פרסומים ומינויים לא יפעלו.

+ (void) setGranted: (BOOL)  granted

משנה את מצב ההרשאה 'בקרבת מקום'.

יש לקרוא לשם כך רק בתגובה לפעולת המשתמש לשינוי מצב ההרשאה.