Классы   Другая ссылка  

Платформа HealthKit обеспечивает структуру, которую приложения могут использовать для совместного использования данных здоровья и пригодности. HealthKit разработан для управления данными из широкого диапазона источников, автоматически объединив данные из всех других источников на основе предпочтений пользователей. Приложения могут также получить доступ к необработанным данным для каждого источника и позволить приложению выполнить свое собственное слияние.

HealthKit также работает непосредственно с устройствами здоровья и пригодности. В iOS 8.0 система может автоматически сохранить данные от совместимого Bluetooth, который сердечный ритм LE контролирует непосредственно в хранилище HealthKit. Система может также автоматически импортировать данные количества шага из сопроцессора движения M7 при наличии. Другие устройства и источники данных должны иметь сопутствующее приложение, которое может получить доступ к данным и сохранить их к HealthKit для них.

HealthKit также обеспечивает приложение, чтобы помочь управлять медицинскими данными пользователя. Медицинское приложение действует как интерфейс пользователя к данным HealthKit. Пользователи могут просмотреть, добавить, удалить, и иначе управлять всеми их данными здоровья и пригодности с помощью этого приложения. Они могут также отредактировать полномочия совместного использования для каждого типа данных.

И HealthKit и медицинское приложение недоступны на iPad. Платформа HealthKit не может использоваться в расширении приложения.

HealthKit и конфиденциальность

Поскольку медицинские данные могут быть чувствительными, HealthKit предоставляет пользовательское управление их данными путем обеспечения тонкозернистого управления информацией, которой могут поделиться приложения. Пользователь должен явно дать каждое разрешение приложения читать и писать данные в хранилище HealthKit. Пользователи могут предоставить или отклонить разрешение отдельно для каждого типа данных. Например, пользователь мог позволить Вашему приложению считать данные количества шага, но препятствовать тому, чтобы он читал уровень глюкозы крови. Для предотвращения возможных информационных утечек приложение не знает, отказали ли ему в разрешении считать данные. С точки зрения приложения, если приложению отказали в разрешении считать данные, не существуют никакие данные того типа.

Данные HealthKit только сохранены локально на устройстве пользователя. Когда устройство не разблокировано, для безопасности шифруется хранилище HealthKit. К хранилищу HealthKit может только получить доступ разрешенное приложение. Вы не можете получить доступ к HealthKit от расширений (как представление Today) или из приложения WatchKit.

Кроме того, Ваше приложение не должно получать доступ к HealthKit APIs, если приложение прежде всего не разработано для обеспечения услуг здоровья или пригодности. Роль Вашего приложения службы здоровья и пригодности должна быть ясной и в Вашем маркетинговом тексте и в Вашем пользовательском интерфейсе. В частности следующие инструкции применяются ко всем приложениям HealthKit.

• Ваше приложение может не использовать информацию, полученную с помощью платформы HealthKit для распространения или подобных служб. Обратите внимание на то, что можно все еще служить распространению в приложении, использующем платформу HealthKit, но Вы не можете использовать данные от хранилища HealthKit для обслуживания объявлений.

• Вы не должны раскрывать информацию, полученную через HealthKit третьему лицу без явно выраженного разрешения от пользователя. Даже с разрешением, можно только поделиться информацией третьему лицу, если они также предоставляют услугу здоровья или пригодности пользователю.

• Вы не можете продать информацию, полученную через HealthKit на рекламные платформы, брокеров данных или информационных реселлеров.

• Если пользователь соглашается, можно совместно использовать его или ее данные HealthKit с третьим лицом для медицинского исследования.

• Необходимо ясно раскрыть пользователю, как Вы и Ваше приложение будете использовать их данные HealthKit.

Необходимо также обеспечить политику конфиденциальности для любого приложения, использующего платформу HealthKit. Можно найти руководство при создании политики конфиденциальности на следующих сайтах:

• Персональная модель Медицинской документации (для non-HIPAA приложений): http://www .healthit.gov/policy-researchers-implementers/personal-health-record-phr-model-privacy-notice

• Модель HIPAA (для HIPAA покрыл приложения): http://www .hhs.gov/ocr/privacy/hipaa/modelnotices.html

Эти модели, разработанные ONC, разработаны для улучшения пользовательского опыта и понимающий при помощи простого языка и доступных проектов, чтобы объяснить, как пользовательские данные собраны и совместно использованы. Они не предназначаются для замены веб-политики конфиденциальности, и разработчики должны консультироваться с руководством ONC, относительно которого модель является подходящей для данного приложения. Эти модели предоставлены для Вашей ссылки только, и Apple явно отказывается от всех обязательств по Вашему использованию таких моделей.

Преимущества от принятия HealthKit

Здоровье и приложения фитнеса получают несколько конкретной выгоды от принятия HealthKit. Некоторые основные преимущества упоминаются ниже.

Разделяя сбор данных, обработку данных и национализацию. Современный опыт здоровья и пригодности включает много различных фасетов, таких как сбор и анализ данных, предоставление практической информации и полезной визуализации пользователю и разрешения пользователям участвовать в социальном сообществе. HealthKit освобождает каждое приложение от ответственности реализации всех этих аспектов. Вместо этого можно фокусироваться на реализации только аспектов, которыми Вы больше всего интересуетесь, оставляя другие задачи большему количеству специализированных приложений.

Это разделение ответственности также приносит преимущества пользователям. Каждый пользователь может свободно выбрать их любимое приложение отслеживания веса, приложение подсчета шага и медицинское приложение проблемы. Этот подход смешивания и подгонки означает, что пользователи могут выбрать комплект приложений с каждым приложением, точно настроенным на их точные потребности. Однако, потому что эти приложения могут свободно обмениваться данными, объединенный комплект обеспечивает лучший опыт, чем какое-либо отдельное приложение могло самостоятельно.

Например, группа друзей могла решить присоединиться к ежедневной проблеме неродного количества. Каждое лицо могло использовать его или ее предпочтительное устройство или приложение для отслеживания шагов, но они могли все все еще использовать то же социальное приложение для проблемы.

Сокращает трение в совместном использовании между приложениями. HealthKit упрощает совместно использовать данные между приложениями. Для разработчиков Вы больше не должны загружать APIs и писать пользовательский код для совместного использования с каждым приложением. Поскольку новые приложения HealthKit становятся доступными, они могут начать совместно использовать автоматически через хранилище HealthKit.

Пользователи получают преимущества, потому что они не должны вручную устанавливать соединения между своими приложениями или импортировать и экспортировать их данные. Значительно, пользователи все еще управляют, какие приложения могут считать и записать данным в хранилище HealthKit — и точно к каким частям данных каждое приложение имеет доступ. Однако, как только пользователь дает разрешение, приложения могут свободно и лишено трения получить доступ к данным друг друга.

Обеспечение более богатого набора данных и большего смысла контекста. Приложения могут получить преимущества путем доступа к более широкому диапазону данных, высказывания каждому приложению большего количества полного мнения о потребностях здоровья и пригодности пользователя. Во многих случаях приложение может изменить свои метрики или уведомление на основе дополнительной информации от хранилища HealthKit. Например, учебное приложение могло предложить закуску проверки сообщения, базируемую не только на числе калорий, которые пользователь записал, но также и на типе и сумме еды, которую он или она съел до сих пор в тот день.

Позволяет приложениям участвовать в большей экосистеме. Приложения получают преимущества путем совместного использования данных, которые они собирают с HealthKit. Становление частью большей экосистемы помогает увеличить видимость и утилиту Вашего приложения. Что более важно, путем принятия HealthKit Вы позволяете своему приложению сотрудничать с другими приложениями, которыми пользователи уже владеют и любят. Если они не могут совместно использовать данные между Вашим приложением и другими приложениями, которые они уже используют, они могут решить искать решение в другом месте.

Принципы проектирования HealthKit

Платформа HealthKit разработана для совместного использования данных между приложениями значимым способом. С этой целью платформа ограничивает типы данных и модулей к предопределенному списку. Эти пределы гарантируют, чтобы другие приложения поняли и что означают данные и как они могут использоваться. В результате разработчики не могут создать пользовательские типы данных или модули. Вместо этого HealthKit пытается обеспечить довольно полный список типов данных и модулей.

Платформа также использует разделение на подклассы настойчиво, производя иерархии подобных классов. Часто, эти классы имеют тонкие но важные различия между ними. Существует также много тесно связанных классов, которые должны быть правильно соединены, прежде чем они смогут сотрудничать успешно. Например, HKObject и HKObjectType абстрактные классы имеют в основном параллельные иерархии конкретных подклассов. При работе с объектами и типами объектов, несомненно, необходимо будет использовать соответствие подклассов.

Все объекты в хранилище HealthKit являются подклассами HKObject класс. Большинство подклассов объекта HealthKit является неизменным. Каждый объект имеет следующие свойства:

• UUID. Уникальный идентификатор для той определенной записи.

• Источник. Источник данных. Источник может быть устройством, непосредственно сохраняющим данные в HealthKit или приложение. Когда объект сохраняется к хранилищу HealthKit, HealthKit автоматически устанавливает источник каждого объекта. Это свойство доступно только на объектах, полученных от хранилища.

• Метаданные. Словарь, содержащий дополнительную информацию о записи. Метаданные могут содержать и предопределенные и пользовательские ключи. Предопределенные ключи помогают упростить совместное использование данных между приложениями. Пользовательские ключи помогают расширить данный тип объекта HealthKit, добавляя специфичные для приложения данные к записи.

Объекты HealthKit могут быть разделены на две основных группы: характеристики и выборки. Характерные объекты представляют обычно не изменяющиеся данные. Эти данные включают дату рождения пользователя, группу крови и биологический пол. Ваше приложение не может сохранить характерные данные. Пользователь должен ввести или изменить эти данные с помощью медицинского приложения.

Демонстрационные объекты представляют данные в определенном моменте времени. Все демонстрационные объекты являются подклассами HKSample класс. У них всех есть следующие свойства:

• Ввести. Демонстрационный тип. Например, это могло включать аналитическую выборку сна, выборку высоты или выборку количества шага.

• Дата начала. Время начала для выборки.

• Дата окончания. Время окончания для выборки. Если выборка представляет единственный момент времени, время окончания должно равняться времени начала. Если выборка представляет данные, собранные по временному интервалу, время окончания должно произойти после времени начала.

Выборки могут быть далее разделены в четыре демонстрационных типа.

• Выборки категории. Эти выборки представляют данные, которые могут быть классифицированы в конечное множество категорий. В iOS 8.0 существует только один тип выборки категории, анализа сна. Для получения дополнительной информации посмотрите Ссылку класса HKCategorySample.

• Выборки количества. Эти выборки представляют данные, которые могут храниться как числовые значения. Выборки количества являются наиболее распространенными типами данных в HealthKit. Они включают высоту и вес пользователя, а также другие данные, такие как число предпринятых шагов, температура пользователя и их частота повторения импульсов. Для получения дополнительной информации посмотрите Ссылку класса HKQuantitySample.

• Корреляции. Эти выборки представляют составные данные — данные, содержащие одну или более выборок. В iOS 8.0 HealthKit использует корреляции для представления еды и кровяного давления. Необходимо всегда использовать корреляцию при создании данных кровяного давления или еды. Для получения дополнительной информации см. Ссылку класса HKCorrelation.

• Проверки. Проверки представляют своего рода физическую активность, как выполнение, плавание, или даже играют. Проверки часто имеют тип, продолжительность, расстояние, и энергия записала свойства. Можно также связать проверку со многими тонкозернистыми выборками. В отличие от корреляций, эти выборки не содержатся в проверке — однако, они могут быть запрошены с помощью проверки. Для получения дополнительной информации см. Ссылку класса HKWorkout.

Установка HealthKit

Прежде чем можно будет начать использовать HealthKit, необходимо выполнить следующие шаги:

1. Включите возможности HealthKit в XCode.

2. Проверьте, чтобы видеть, доступен ли HealthKit путем вызова isHealthDataAvailable метод. HealthKit не доступен на iPad. Кроме того, HealthKit может быть отключен на других устройствах — например, iPhone, настраивающиеся для школ или корпоративных сред.

3. Инстанцируйте HKHealthStore возразите для своего приложения. Вам нужно только одно хранилище HealthKit на приложение. Это хранилище действует как Ваш основной интерфейс с базой данных HealthKit.

4. Авторизация запроса получить доступ к данным HealthKit с помощью requestAuthorizationToShareTypes:readTypes:completion: метод. HealthKit требует тонкозернистой авторизации. Необходимо запросить разрешение совместно использовать и считать каждый тип данных.

   Можно также обеспечить пользовательские сообщения для листа разрешения с помощью NSHealthShareUsageDescription и NSHealthUpdateUsageDescription ключи в Вашем приложении info.plist файл.

После запроса авторизации Ваше приложение готово получить доступ к хранилищу HealthKit. Если Ваше приложение имеет разрешение совместно использовать тип данных, это может создать и сохранить выборки того типа. Необходимо проверить, что приложение имеет разрешение совместно использовать данные путем вызова authorizationStatusForType: прежде, чем попытаться сохранить любые выборки.

Если Ваше приложение имеет разрешение считать тип данных, можно запросить те данные от хранилища HealthKit; однако, даже знание, что пользователь отрицал, что Ваш запрос считывает данные, могло показать частную медицинскую информацию. Поэтому Ваше приложение не может определить, имеет ли оно разрешение считать определенный тип данных. Если пользователь не дает разрешение, запросы для ограниченных типов данных возвращают только выборки, которые совместно использовало Ваше приложение. Иначе, хранилище HealthKit, кажется, пусто.

Для получения дополнительной информации об установке HeathKit посмотрите Ссылку класса HKHealthStore.

Для практического примера, демонстрируя, как установить и использовать HealthKit, сочтите целесообразным: Сохраните и Получите Данные HealthKit.

Добавление выборок к хранилищу HealthKit

Ваше приложение может создать новые выборки и добавить их к хранилищу HealthKit. Общая процедура подобна для всех демонстрационных типов, хотя каждый тип имеет свои собственные изменения на этой теме.

1. Ищите корректный идентификатор типа в Ссылке Констант HealthKit.

2. Создайте соответствие HKObjectType подкласс, с помощью идентификатора типа. Для списка удобных методов посмотрите Ссылку класса HKObjectType.

3. Создайте соответствие HKSample подкласс, с помощью типа объекта.

4. Сохраните объект к хранилищу HealthKit с помощью saveObject:withCompletion: метод.

Каждый HKSample подкласс имеет свои собственные удобные методы для инстанцирования его демонстрационных объектов. Эти методы изменяют процедуру, как описано ниже.

Для выборок количества необходимо создать экземпляр HKQuantity класс. Модули количества должны соответствовать допустимым модулям, описанным в документации идентификатора типа. Например, HKQuantityTypeIdentifierHeight документация утверждает, что использует модули длины. Поэтому Ваше количество должно использовать сантиметры, метры, футы, дюймы или другой совместимый модуль. Для получения дополнительной информации посмотрите Ссылку класса HKQuantitySample.

Для выборок категории значение должно соответствовать перечислению, описанному в документации идентификатора типа. Например, HKCategoryTypeIdentifierSleepAnalysis документация утверждает, что использует HKCategoryValueSleepAnalysis перечисление. Поэтому необходимо передать значение от этого перечисления при создании этой выборки. Для получения дополнительной информации посмотрите Ссылку класса HKCategorySample.

Для корреляций необходимо сначала создать все демонстрационные объекты, что корреляция будет содержать. Идентификатор типа корреляции описывает и тип и число объектов, которые могут содержаться. Не сохраняйте содержащие в нем объекты в хранилище HealthKit. Они сохранены как часть корреляции. Для получения дополнительной информации см. Ссылку класса HKCorrelation.

Проверки ведут себя несколько по-другому, чем другие выборки. Во-первых, Вам не нужен идентификатор определенного типа для создания HKWorkoutType экземпляр. Все проверки используют тот же идентификатор типа. Во-вторых, необходимо будет обеспечить HKWorkoutActivityType значение для каждой проверки. Это значение определяет тип действия, выполняемого во время проверки. Наконец, после того, как проверка сохраняется к хранилищу HealthKit, можно связать дополнительные выборки с проверкой. Эти выборки предоставляют тонкозернистую подробную информацию о проверке. Для получения дополнительной информации см. Ссылку класса HKWorkout.

Доступ к данным HealthKit

Хранилище HealthKit обеспечивает много методов для доступа к его данным.

• Вызовы прямого метода. Хранилище HealthKit обеспечивает методы для прямого доступа к характерным данным. Эти методы могут использоваться только для доступа к характерным данным. Для получения дополнительной информации посмотрите Ссылку класса HKHealthStore.

• Демонстрационный запрос. Это - запрос общего назначения. Используйте демонстрационные запросы для доступа к любому типу демонстрационных данных. Когда Вы хотите сортировать результаты или ограничить общее количество возвращенных выборок, демонстрационные запросы особенно полезны. Для получения дополнительной информации посмотрите Ссылку класса HKSampleQuery.

• Запрос наблюдателя. Это - продолжительный запрос, контролирующий хранилище HealthKit и предупреждающий Вас к любым изменениям в соответствии выборок. Используйте запросы наблюдателя, когда Вы захотите быть уведомленными об изменениях в хранилище. Можно зарегистрировать эти запросы для фоновой поставки. Для получения дополнительной информации посмотрите Ссылку класса HKObserverQuery.

• Запрос привязанного объекта. Используйте этот запрос для поиска элементов, добавленных к хранилищу. В первый раз, когда запрос привязки выполняется, он возвращает все соответствующие выборки в хранилище. На последующих выполнениях это возвращает только те элементы, добавленные начиная с последнего выполнения. Вы будете часто использовать запросы привязанного объекта с запросами наблюдателя. Запрос наблюдателя говорит Вам, когда что-то изменилось. Запрос привязанного объекта определяет то, что (если что-нибудь) было добавлено к хранилищу. Для получения дополнительной информации посмотрите Ссылку класса HKAnchoredObjectQuery.

• Запрос статистики. Используйте этот запрос для выполнения статистических вычислений по набору соответствия выборок. Можно использовать запросы статистики для вычисления суммы, минимума, максимума или среднего значения в наборе. Для получения дополнительной информации посмотрите Ссылку класса HKStatisticsQuery.

• Запрос набора статистики. Используйте этот запрос для выполнения многократных запросов статистики по серии временных интервалов фиксированной длины. Вы будете часто использовать эти запросы при создании графиков. Они обеспечивают простой метод для вычисления вещей, таких как общее количество калорий, используемых каждый день или число шагов, предпринятых в каждом 5-минутном интервале. Запросы набора статистики являются продолжительными запросами. В то время как они могут возвратить текущий набор статистики, они могут также контролировать хранилище HeathKit и реагировать на обновления. Для получения дополнительной информации посмотрите Ссылку класса HKStatisticsCollectionQuery.

• Запрос корреляции. Используйте этот запрос для выполнения сложных поисков данных, содержавшихся в корреляции. Эти запросы могут содержать отдельные предикаты для каждого из демонстрационных типов, сохраненных в корреляции. Если Вы просто хотите соответствовать тип корреляции, используйте демонстрационный запрос вместо этого. Для получения дополнительной информации см. Ссылку класса HKCorrelation.

• Исходный запрос. Используйте этот запрос для поиска источников (приложения и устройства), которые сохранили соответствие данных к хранилищу HealthKit. Исходные списки запросов все источники, сохраняющие определенный демонстрационный тип. Для получения дополнительной информации посмотрите Ссылку класса HKSourceQuery.

Работа с модулями

HealthKit предоставляет поддержку для модулей с помощью HKUnit и HKQuantity классы. HKUnit обеспечивает представление для единого блока. Это поддерживает широкий диапазон метрических и имперских модулей, а также и простые и комплексные единицы. Простой модуль представляет единственное измерение, такое как метры, фунты или секунды. Комплексная единица объединяется один или несколько простые модули с помощью математических операций, такого m/s или ^lb/ft2.

HKUnit класс обеспечивает удобные методы создать все простые модули, поддерживаемые HealthKit. Это также обеспечивает, математические операции должны были создать комплексные единицы. Наконец, можно создать комплексные единицы непосредственно с помощью должным образом отформатированных строк модуля.

Для получения дополнительной информации о модулях см. Ссылку класса HKUnit.

HKQuantity класс хранит значение для данного модуля. Можно тогда запросить значение в любых совместимых модулях. Таким образом, Ваше приложение легко переводят значения между модулями.

Для получения дополнительной информации о количествах см. Ссылку класса HKQuantity.

В некоторых случаях можно локализовать количества с помощью средств форматирования. iOS 8 обеспечивает новые средства форматирования для длины (NSLengthFormatter), масса (NSMassFormatter), и энергия (NSEnergyFormatter). Для других количеств необходимо будет выполнить преобразования и локализовать данные сами.

Поточная обработка

Хранилище HealthKit ориентировано на многопотоковое исполнение, и большинство объектов HealthKit является неизменным. В целом можно использовать HealthKit безопасно в многопоточной среде.

Для получения дополнительной информации о многопоточности и параллельном программировании, см. Руководство по программированию Параллелизма.

Добавление цифровых подписей

Объект метаданных цифровой подписи в HealthKit предназначается для обеспечения целостности данных для демонстрационных записей, сгенерированных доверенным устройством. Этот элемент метаданных хранит снабженную цифровой подписью копию демонстрационной записи. Подпись сгенерирована устройством (который должен быть стойкой трамбовкой, так как это хранит частный ключ подписи). Это позволяет потребителю данных проверять подпись по известному открытому ключу для того устройства, чтобы проверить, что не были изменены рекордные данные. Так как каждая запись подписывается индивидуально, хранение наверху находится на порядке 1K байтов на запись. Таким образом этот элемент подписи метаданных предназначается для записей, где частота дискретизации составила несколько раз в день. Более высокие частоты дискретизации потребуют, чтобы подписи применились к объединенным группам выборок, который выходит за рамки этого документа.

Как правило, закрытый ключ был бы настроен к трамбовке стойкое устройство измерения во время изготовления. (Любые политики или механизмы для перенастройки с закрытым ключом или обновления сертификата выходят за рамки этого документа). Соответствующий открытый ключ был бы опубликован производителем устройств, например, на их веб-странице. Для каждой выборки устройство передало бы демонстрационную запись, а также подпись к приложению для iOS, которое сохранит оба элемента в базе данных HealthKit. Обратите внимание на то, что пара частная с открытым ключом используется для цифровой подписи для обеспечения целостности данных, не для шифрования. Фактические значения в записи данных находятся в открытом тексте.

Форматом, используемым для цифровой подписи, является CMS (Криптографическое сообщение Синтаксис) указанный в IETF RFC 5652. Подпись кодируется с помощью ASN.1 с DER (Выдающиеся Правила кодирования). Используемый дайджест сообщения должен быть SHA256, и шифром подписи должен быть FIPS PUB Эллиптическая кривая Стандарта цифровой подписи 186-4 P-256. Это гарантирует и силу и эффективность. Кроме того, вся подпись должна быть base64, закодированным так, чтобы это могло быть сохранено в объекте метаданных HealthKit NSString.

Подпись должна иметь Тип контента Данных со знаком ASN.1:

где Тип SignerInfo:

Алгоритмы выборки сообщений и алгоритмы сигнатуры как отмечены выше. Дополнительные элементы были не учтены. SignerIdentifier используется для получения надлежащего открытого ключа для верификации подписи.

EncapsulatedContentInfo должен быть копией соответствующих элементов от демонстрационной записи, сгенерированной устройством. Эта копия должна быть закодирована с помощью ASN.1 DER и должна содержать, по крайней мере, демонстрационную метку времени и демонстрационное значение. Причина рекордные данные копируются в подписи, в порядке для имения стабильного четко определенного двоичного кодирования (ASN.1 DER) данных, которые необходимы для создания подписи поддающейся проверке. plist структура (пары ключ/значение), который является закодированным ASN.1, должна быть достаточной для наиболее типов записи. (См. “Кодирование plist структуры с DER ASN.1”).