iOS. Приемы программирования Нахавандипур Вандад
Если запустить этот код на устройстве с iOS, оборудованном гироскопом, например на новом iPhone, то результаты будут иными:
Gyro is available. // гироскоп доступен
Gyro is not active. // гироскоп неактивен
Обсуждение
Если вы планируете выпустить приложение, в котором используется гироскоп, то нужно гарантировать, что ваша программа сможет работать и на других устройствах с iOS, где нет такого оборудования. Например, если вы используете гироскоп как элемент игры, то нужно убедиться в том, что игра будет работать и на других устройствах, хотя гироскопа они и не имеют. Ведь не во всех устройствах с iOS он установлен. Именно наличие гироскопа в устройстве мы и будем проверять в данном разделе.
Чтобы решить эту задачу, потребуется инстанцировать объект типа CMMotionManager. После этого мы должны будем получить доступ к логическому методу isGyroAvailable и посмотреть, доступен ли гироскоп на том устройстве, где выполняется ваш код. Кроме того, можно воспользоваться методом isGyroActive экземпляра CMMotionManager, чтобы узнать, посылает ли гироскоп в настоящее время обновления вашему приложению. Подробнее об этом поговорим в разделе 18.5.
См. также
Раздел 18.5.
18.3. Получение данных акселерометра
Постановка задачи
Требуется указать операционной системе iOS, чтобы она посылала вашей программе данные от акселерометра.
Решение
Пользуйтесь методом экземпляра startAccelerometerUpdatesToQueue: withHandler:, относящимся к классу CMMotionManager. Вот заголовочный файл контроллера вида, в котором класс CMMotionManager применяется для получения обновлений от акселерометра:
#import «ViewController.h»
#import <CoreMotion/CoreMotion.h>
@interface ViewController ()
@property (nonatomic, strong) CMMotionManager *motionManager;
@end
@implementation ViewController
Мы реализуем контроллер вида и воспользуемся методом startAccelerometerUpdatesToQueue: withHandler: класса CMMotionManager:
— (void)viewDidLoad{
[super viewDidLoad];
self.motionManager = [[CMMotionManager alloc] init];
if ([self.motionManager isAccelerometerAvailable]){
NSOperationQueue *queue = [[NSOperationQueue alloc] init];
[self.motionManager
startAccelerometerUpdatesToQueue: queue
withHandler: ^(CMAccelerometerData *accelerometerData, NSError *error) {
NSLog(@"X = %.04f, Y = %.04f, Z = %.04f",
accelerometerData.acceleration.x,
accelerometerData.acceleration.y,
accelerometerData.acceleration.z);
}];
} else {
NSLog(@"Accelerometer is not available.");
}
}
Обсуждение
Акселерометр фиксирует данные по трем измерениям (то есть по осям декартовых координат), которые iOS сообщает вашей программе как значения x, y и z. Эти значения инкапсулируются в структуре CMAcceleration:
typedef struct {
double x;
double y;
double z;
} CMAcceleration;
Предположим, что вы держите устройство с iOS прямо перед собой, экран обращен к вам и находится в книжной ориентации. В таком случае:
• ось X расположена слева направо и проходит по центру экрана устройства. При этом значения изменяются слева направо в диапазоне от –1 до +1;
• ось Y расположена снизу вверх и проходит по центру экрана устройства. При этом значения изменяются снизу вверх в диапазоне от –1 до +1;
• ось Z проходит через заднюю плоскость устройства, потом через все устройство и через экран — по направлению к вам. При этом значения изменяются от задней до передней плоскости устройства в диапазоне от –1 до +1.
Значения, принимаемые от акселерометра, лучше всего разобрать на примерах. Предположим, что вы держите устройство с iOS вертикально экраном к себе. Его нижняя сторона обращена вниз, верхняя — вверх. Если вы будете держать устройство совершенно ровно, не наклоняя его ни в одну из сторон, в этот момент по осям X, Y и Z вы зафиксируете следующие значения: x = 0,0; y = –1,0; z = 0,0. А теперь примем это положение за исходное и попробуем выполнить следующие манипуляции.
1. Повернем устройство на 90° по часовой стрелке. В этот момент вы зафиксируете значения x = +1,0; y = 0,0; z = 0,0.
2. Повернем устройство еще на 90° по часовой стрелке. В данный момент верхняя сторона устройства должна указывать вниз. При этом вы зафиксируете значения x = 0,0; y = +1,0; z = 0,0.
3. Повернем устройство еще на 90° по часовой стрелке. В данный момент верхняя сторона устройства должна указывать влево. При этом вы зафиксируете значения x = –1,0; y = 0,0; z = 0,0.
4. Наконец, если еще раз повернем устройство на 90° по часовой стрелке, так, чтобы верхняя сторона устройства опять была направлена вверх, а нижняя — вниз, то мы вернемся к исходным значениям x = 0,0; y = –1,0; z = 0,0.
Таким образом, можно сделать вывод, что при вращении устройства вокруг оси Z меняются значения x и y, сообщаемые акселерометром, а значение z остается неизменным.
Проведем другой эксперимент. Снова расположим устройство горизонтально, так, чтобы его задняя поверхность была обращена вниз, передняя — вверх. Как вы уже знаете, в таком случае акселерометр зафиксирует значения x = 0,0; y = –1,0; z = 0,0. А теперь попробуйте выполнить следующие манипуляции.
1. Наклоните устройство назад на 90° по оси X так, чтобы его верхняя сторона указывал назад, то есть держите его так, как будто оно лежит на столе экраном вверх. В этот момент вы зафиксируете значения x = 0,0; y = 0,0; z = –1,0.
2. Теперь поверните устройство еще на 90° назад, так, чтобы задняя поверхность была обращена к вам, верхняя сторона была направлена вниз, а нижняя — вверх. В этот момент акселерометр зафиксирует значения x = 0,0; y = 1,0; z = 0,0.
3. Поверните устройство еще на 90° назад. Теперь его экран должен смотреть вниз, задняя поверхность — вверх, а верхняя сторона должна быть направлена к вам. В этот момент акселерометр должен показывать значения x = 0,0; y = 0,0; z = 1,0.
4. И наконец, если еще раз повернуть устройство в том же направлении, чтобы экран был направлен к вам, верхняя сторона устройства — вверх и т. д., то акселерометр покажет исходные значения, с которых мы начали второй опыт.
Итак, можно сделать вывод, что при вращении устройства вокруг оси X изменяются значения по осям Y и Z, но не по оси X. Можете попробовать и третий тип вращения — по оси Y (она идет сверху вниз) — и посмотреть, как изменяются значения по осям X и Z.
Получать обновления от акселерометра можно двумя способами.
• Пользоваться методом экземпляра startAccelerometerUpdatesToQueue: withHandler:, относящимся к классу CMMotionManager. Этот метод будет доставлять обновления, поступающие от акселерометра, в рабочую очередь (здесь мы имеем дело с очередью типа NSOperationQueue). Для работы с ним нужно иметь базовое представление о блоках, которые активно используются при работе с Grand Central Dispatch (GCD). Подробнее о блоках рассказано в главе 7.
• Пользоваться методом экземпляра startAccelerometerUpdates, относящимся к классу CMMotionManager. Как только вы вызовете этот метод, акселерометр (при его наличии) начнет обновлять свои данные в объекте менеджера движений (Motion Manager). Нужно создать отдельный поток для непрерывного считывания значений свойства accelerometerData (типа CMAccelerometerData) класса CMMotionManager.
В этом разделе мы использовали первый подход (с применением блоковых объектов). Прежде чем продолжать работу с этим разделом, рекомендую внимательно изучить главу 7. Блок, который мы предоставляем методу экземпляра startAccelerometerUpdatesToQueue: withHandler:, относящемуся к классу CMMotionManager, должен быть объектом типа CMAccelerometerHandler:
typedef void (^CMAccelerometerHandler)
(CMAccelerometerData *accelerometerData, NSError *error);
Иными словами, блок должен принимать два параметра. Первый параметр должен относиться к типу CMAccelerometerData, второй — к типу NSError. Так мы и сделали в приведенном примере кода.
См. также
Раздел 18.1.
18.4. Обнаружение встряхивания устройства с iOS
Постановка задачи
Необходимо узнавать, когда пользователь встряхивает устройство с iOS.
Решение
Пользуйтесь методом motionEnded: withEvent:. Он может относиться к любому объекту вашего приложения, если этот объект принадлежит к типу UIResponder. Так, это могут быть контроллеры видов и даже объект основного окна.
Обсуждение
Метод motionEnded: withEvent: окна вашего приложения вызывается всякий раз, когда операционная система iOS фиксирует движение. Простейшая реализация этого метода такова:
— (void) motionEnded:(UIEventSubtype)motion
withEvent:(UIEvent *)event{
/* Обрабатываем движение. */
}
Как видите, параметр motion относится к типу UIEventSubtype. Тип UIEventSubtype имеет, в частности, значение UIEventSubtypeMotionShake, которое нас и интересует. Зарегистрировав такое событие, мы можем быть уверены в том, что пользователь встряхнул устройство.
Далее переходим к реализации контроллера вида и обрабатываем метод motionEnded: withEvent::
— (void) motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event{
if (motion == UIEventSubtypeMotionShake){
UIAlertView *alert =
[[UIAlertView alloc] initWithTitle:@"Shake"
message:@"The device is shaken"
delegate: nil
cancelButtonTitle:@"OK" otherButtonTitles: nil];
[alert show];
}
}
Если теперь встряхнуть устройство или имитировать такое движение в эмуляторе iOS (см. введение к этой главе), в окне консоли мы увидим текст Detected a shake (Обнаружено встряхивание).
18.5. Получение данных гироскопа
Постановка задачи
Требуется получать информацию о движении устройства от гироскопа, установленного в устройстве с iOS.
Решение
Выполните следующие шаги.
1. Выясните, имеется ли в данном устройстве гироскоп. О том, как это делается, рассказано в разделе 18.2.
2. Если гироскоп в устройстве есть, проверьте, не посылает ли он уже уведомления. О том, как это делается, рассказано в разделе 18.2.
3. Воспользуйтесь методом экземпляра setGyroUpdateInterval:, относящимся к классу CMMotionManager, чтобы указать, сколько обновлений вы хотите получать в секунду. Например, если вы желаете получать 20 обновлений в секунду, задайте здесь значение 1.0/20.0.
4. Активизируйте метод экземпляра startGyroUpdatesToQueue: withHandler:, относящийся к классу CMMotionManager. Объект очереди может просто представлять собой главную операционную очередь (как мы увидим позже), а блок обработчика должен соответствовать формату CMGyroHandler.
Эти шаги реализуются в следующем коде:
— (BOOL) application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
CMMotionManager *manager = [[CMMotionManager alloc] init];
if ([manager isGyroAvailable]){
if ([manager isGyroActive] == NO){
[manager setGyroUpdateInterval:1.0f / 40.0f];
NSOperationQueue *queue = [[NSOperationQueue alloc] init];
[manager
startGyroUpdatesToQueue: queue
withHandler: ^(CMGyroData *gyroData, NSError *error) {
NSLog(@"Gyro Rotation x = %.04f", gyroData.rotationRate.x);
NSLog(@"Gyro Rotation y = %.04f", gyroData.rotationRate.y);
NSLog(@"Gyro Rotation z = %.04f", gyroData.rotationRate.z);
}];
} else {
NSLog(@"Gyro is already active.");
}
} else {
NSLog(@"Gyro isn't available.");
}
self.window = [[UIWindow alloc] initWithFrame:
[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = [UIColor whiteColor];
[self.window makeKeyAndVisible];
return YES;
}
Обсуждение
Класс CMMotionManager позволяет программисту получить от операционной системы iOS обновления данных гироскопа. Сначала нужно убедиться в том, что гироскоп имеется в том устройстве с iOS, где работает ваше приложение (подробнее об этом рассказано в разделе 18.2). Убедившись в этом, можно вызвать метод экземпляра setGyroUpdateInterval:, относящийся к классу CMMotionManager, чтобы задать количество обновлений, которые вы хотите получать от гироскопа в секунду. Например, если вам требуется N обновлений в секунду, задайте здесь значение 1.0/N.
Установив интервал обновлений, можно вызвать метод экземпляра startGyroUpdatesToQueue: withHandler:, относящийся к классу CMMotionManager, — так задается блок для обработки обновлений. О блоках подробнее рассказано в главе 7. Блоковый объект должен относиться к типу CMGyroHandler, принимающему два параметра.
• gyroData — данные, поступающие от гироскопа, заключены в объекте типа CMGyroData. Можно использовать свойство rotationRate класса CMGyroData (это структура) для получения доступа к значениям x, y и z. Эти значения представляют три эйлерова угла, называемых соответственно крен, тангаж и рыскание. Подробнее эти углы рассматриваются в работах по аэродинамике.
• error — ошибка типа NSError, которая может возникнуть, когда гироскоп посылает нам обновления.
Если вы не хотите работать с блоковыми объектами, нужно вызвать метод экземпляра startGyroUpdates, относящийся к классу CMMotionManager, — вместо метода экземпляра startGyroUpdatesToQueue: withHandler: того же класса, — а также создать специальный собственный поток. В этом потоке мы будем считывать обновления, поступающие от гироскопа и передаваемые свойству gyroData экземпляра используемого нами класса CMMotionManager.
См. также
Раздел 18.2.
Глава 19. Фреймворк Pass Kit
19.0. Введение
Пожалуй, всем приходилось иметь дело с проездными билетами, дисконтными картами и скидочными талонами. Например, вы ходите в кофейню, в которой постоянным клиентам раздают специальные дисконтные карты. Если вы уже успели заказать определенное количество чашек кофе, то вам предложат бесплатную чашечку за счет заведения. Дисконтные карты используются и в магазинах. Например, вы можете купить в супермаркете продукты на сумму X, за что вам выдадут дисконтную карту или скидочный купон, которые можно будет использовать, когда вы в следующий раз придете в этот магазин.
На рис. 19.1 показано, как на устройстве с iOS выглядит обычный (бесплатный) железнодорожный билет, отображенный в Passbook.
Рис. 19.1. Железнодорожный билет, представленный в виде талона в приложении Passbook на устройстве с iOS
Приложения iOS для взаимодействия с такими бесплатными билетами могут использовать также фреймворк Passbook. Вернемся к примеру с кофейней. Если мы пишем мобильное приложение для этой кофейни, то можем предусмотреть в нем и такую возможность: посетитель добавляет к дисконтной карточке некоторую сумму, что позволяет ему не только выпить кофе, но и воспользоваться Wi-Fi-соединением. Итак, когда пользователь открывает такое приложение, он замечает в базе данных Passbook клубный талон, полученный именно в этой кофейне. Пользователь может добавить некоторую сумму к этому талону прямо на устройстве, а затем сообщить барриста, что внес плату за пользование сетью через приложение, где имеется виртуальный клубный талон.
Pass Kit — это цифровое решение от Apple для осуществления именно таких транзакций. Итак, разберемся с терминологией, а затем изучим эту тему подробнее.
• Pass Kit. Фреймворк Pass Kit от Apple позволяет разработчикам доставлять виртуальные скидочные талоны, снабженные цифровой подписью, на совместимые устройства с операционной системой iOS 6 и выше.
Passbook. Клиентское приложение на устройствах с iOS 7. Позволяет хранить и обрабатывать талоны, созданные разработчиками, а также управлять этими талонами.
Итак, мы (разработчики) будем пользоваться Pass Kit для создания талонов с цифровой подписью и доставки их нашим пользователям. Пользователям потребуется взаимодействовать с талонами, которые мы для них создаем, для этого они будут использовать приложение Passbook, установленное на устройстве. Итак, мы сможем выдавать пользователям в цифровой форме различные талоны, проездные билеты, скидочные купоны, дисконтные и клубные карты и т. д. Не придется носить целую стопку карточек в кошельке. Весь этот контент можно хранить в одном месте — в приложении Passbook для iOS.
Прежде чем опробовать эту новую технологию, рассмотрим общую картину: как именно спроектировано такое хранилище и как оно помогает достигать наших целей. Я разделил эту концепцию на несколько более мелких элементов. Рассмотрим, как доставлять пользователям талоны, снабженные цифровой подписью.
1. Разработчик создает сертификат и соответствующий ему закрытый ключ. Это делается на портале инициализации Apple (Apple Provisioning Portal).
2. Затем разработчик создает ряд файлов. Они будут представлять собой талон, который мы позже доставим пользователю.
3. Разработчик подписывает созданный талон с применением того сертификата, который был создан на первом этапе.
4. Разработчик тем или иным способом доставляет талон пользователю.
5. Пользователь увидит талон и сможет добавить его на свое устройство.
6. Как только талон окажется на пользовательском устройстве, Passbook сохранит его для последующего использования до тех пор, пока пользователь не решит удалить талон.
Конечно, после прочтения этого списка у вас могла еще не сложиться целостная картина. На рис. 19.2 все показано наглядно.
Рис. 19.2. Создание и распространение среди пользователей талонов с цифровой подписью в операционных системах iOS 6 и выше
Все детали процесса будут подробно описаны в разделах этой главы. Некоторые технологические аспекты Pass Kit, связанные с тем, как обеспечивать актуальность ваших талонов и отсылать уведомления с сервера, требуют определенных знаний о серверном программировании. Ради упрощения материала мы не будем в этой главе останавливаться на данных аспектах, а поговорим преимущественно о создании талонов. Научившись создавать талоны, вы сможете распространять их разными способами. Два из таких способов объяснены в этой главе. Те детали, которые связаны не с системой iOS непосредственно, а с серверной разработкой, в этой главе не рассматриваются.
19.1. Создание сертификатов Pass Kit
Постановка задачи
Требуется распространять между пользователей талоны с цифровой подписью. Для этого первым делом нужно создать цифровые сертификаты для подписывания ваших талонов.
Решение
Создавайте цифровые сертификаты на портале инициализации iOS.
Обсуждение
Как было объяснено во введении к этой главе, для распространения талонов между пользователями эти талоны требуется снабжать цифровыми подписями. А перед этим нужно получить в Apple сертификат, который позволил бы уникально связать все талоны с вашей учетной записью разработчика. Таким образом Apple отличает «настоящие» талоны от «ненастоящих».
При создании сертификата выполните следующие шаги.
1. В браузере откройте центр разработки для iOS (iOS Dev Center). Не буду ставить здесь ссылку, так как со временем она может измениться. Просто введите такой запрос в поисковик — и он выдаст вам нужный сайт в мгновение ока.
2. Если вы еще не вошли на сайт под вашей учетной записью, сделайте это.
3. Оказавшись в системе, перейдите на страницу Certificates, Identifiers & Profiles (Сертификаты, идентификаторы, профили).
4. Перейдите на страницу Identifiers (Идентификаторы) и далее на страницу Pass Type ID (ID типа талона). Соответствующий раздел находится в левой части экрана.
5. Когда вы окажетесь на нужной странице, она, возможно, еще будет пуста. Найдите и нажмите экранную кнопку +.
6. Теперь в поле Description (Описание) введите текст, который будет описывать ID типа вашего талона.
7. В поле Identifier (Идентификатор) введите идентификатор талона в формате обратного доменного имени. Например, если ID вашего приложения — com.pixolity.testingpasskit, то для талонов, интегрированных с данным приложением, подойдет идентификатор pass.pixolity.ios.cookbook.testingpasses. Разумеется, следует подбирать для идентификаторов талонов такие названия, которые что-то означают в контексте вашего приложения. На практике принято начинать имя идентификатора с pass, а затем можно писать все, что хотите. На рис. 19.3 показано, как нужно заполнять поля на этой странице.
Рис. 19.3. Внесение информации о простом идентификаторе типа талона
Когда закончите заполнение этой страницы, нажмите кнопку Continue (Продолжить). Вам для предварительного просмотра будет представлен талон. Если вас все устроит, просто нажмите кнопку Register (Зарегистрировать) (рис. 19.4). Итак, теперь у вас есть идентификатор типа талона. Но он пока не связан ни с одним сертификатом. Чтобы создать сертификат и ассоциировать его с вашим идентификатором типа талона, выполните следующие шаги.
Рис. 19.4. Если вся информация указана правильно, подтвердите создание ID типа талона
1. В разделе Pass Type ID (Идентификаторы типа талона) на портале инициализации iOS найдите созданный вами идентификатор и нажмите кнопку Settings (Настройки) (рис. 19.5). В столбце Pass Certificate (Сертификаты талонов) в этом списке вы увидите, что ваш идентификатор типа талона обозначен как None (Отсутствует). В столбце Action (Действия) нажмите ссылку Configure (Сконфигурировать).
Рис. 19.5. Задаем идентификатор типа талона
2. Выбрав на портале идентификатор типа талона, вы сможете создать для него сертификат (рис. 19.6). Просто нажмите кнопку Create Certificate (Создать сертификат).
Рис. 19.6. Мы готовы создать сертификат для идентификатора типа талона
3. Теперь вам будет предложено создать запрос на подписывание сертификата, воспользовавшись доступом к связке ключей на Mac (рис. 19.7). Следуйте инструкциям, которые видите на экране. Когда закончите создание запроса на подписывание сертификата, нажмите экранную кнопку Continue (Продолжить).
Рис. 19.7. Выполняйте инструкции по созданию запроса на подписывание сертификата
Запрос на подписывание сертификата можно создать не только в Mac. Для создания такого запроса необходимо убедиться, что на вашей машине установлен Open SSL. Описание генерирования сертификатов на машинах, где не установлен Mac, выходит за рамки этой книги. Однако, если вас интересует этот вопрос, вы легко найдете ответ на него в Интернете — достаточно немного поискать.
Создавая на компьютере запросы на подписывание сертификата (это делается с помощью доступа к связке ключей), вы также создаете закрытый ключ, ассоциированный с таким сертификатом. Apple рекомендует время от времени делать резервные копии базы данных связки ключей, так как на портале инициализации iOS эти ключи не сохраняются. Если вы переходите к работе с новым компьютером, то ваши ключи туда нужно будет перенести вручную. Поэтому они и называются закрытыми. Экспортировать закрытые ключи несложно: щелкните на ключе правой кнопкой мыши и выберите в контекстном меню команду Export (Экспортировать).
4. Далее в браузере вам будет предложено загрузить запрос на подписывание сертификата на сайт Apple, чтобы в ответ получить готовый сертификат. Закрытый ключ был создан на вашем компьютере в тот самый момент, когда вы подготовили запрос на подписывание сертификата. Сертификат, который Apple выдаст по окончании процесса, будет подходить к закрытому ключу. Далее нажмите кнопку Choose File (Выбрать файл) на этом экране, чтобы выбрать запрос на подписывание сертификата, созданный для вас связкой ключей (рис. 19.8). Сделав это, нажмите кнопку Generate (Сгенерировать).
Рис. 19.8. Загрузка запроса на подписывание сертификата на сайт Apple для получения ссылки на сертификат
5. Когда сертификат сгенерирован, вы увидите примерно такой экран, как на рис. 19.9. Нажмите кнопку Download (Скачать), чтобы скачать сгенерированный сертификат.
Рис. 19.9. Apple сообщает вам о том, что сертификат создан успешно
6. Теперь у вас на диске должен быть готовый сертификат. Найдите этот файл и дважды щелкните на нем кнопкой мыши, чтобы импортировать его в вашу связку ключей. Чтобы убедиться, что все сработало правильно, откройте на компьютере программу для доступа к связке ключей (Keychain Access), там перейдите в раздел Login (Учетная запись) и далее — в подраздел My Certificate (Мой сертификат). Затем в правой части экрана подтвердите, что ваш сертификат на месте и что он ассоциирован с закрытым ключом (рис. 19.10).
Рис. 19.10. Сертификат, сгенерированный Apple, правильно ассоциирован с закрытым ключом
Итак, вы создали сертификат и готовы подписывать талоны, а потом рассылать их на устройства с iOS.
См. также
Раздел 19.0.
19.2. Создание файлов талонов
Постановка задачи
Требуется создать файл талона, представляющий данные, которые должны сохраняться на пользовательском устройстве с iOS.
Решение
Создайте файл pass.json и заполните его соответствующими ключами и значениями.
Обсуждение
Для представления талонов во фреймворке Pass Kit компания Apple выбрала формат JSON. Аббревиатура JSON расшифровывается как «объектная нотация JavaScript», широко используется в веб-приложениях и веб-службах. Однако вы, будучи iOS-разработчиком, можете и не иметь достаточных знаний о JSON.
Файлы JSON состоят из обычных ключей и значений, этим они напоминают словари. Ключ может иметь значение, а значения могут быть самыми разными — от простой строки до словаря, который и сам содержит ключи и значения. Вот простой пример JSON, обладающий всеми характерными чертами этой нотации: