HealthKit Espace de noms

Référence

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.

Classes

HKActivitySummary	Résume l’activité des utilisateurs pour un jour spécifique.
HKActivitySummaryQuery	Obtient HKActivitySummary des instances qui correspondent à un NSPredicate.
HKActivitySummaryType	Objet utilisé pour demander l’autorisation de lire HKActivitySummary des objets.
HKAnchoredObjectQuery	qui HKQuery , lors de son appel initial, retourne le résultat le plus récent et, dans les appels suivants, retourne uniquement les données ajoutées après l’appel initial.
HKBiologicalSexObject	Retourné par GetBiologicalSex(NSError).
HKBloodTypeObject	Retourné par GetBloodType(NSError)
HKCategorySample	dont HKSample la valeur est l’une d’un type énuméré.
HKCategoryType	qui HKSampleType n’a actuellement qu’une seule forme : l’analyse du sommeil.
HKCategoryTypeIdentifierExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKCategoryTypeIdentifierKey	Définit les clés à identifier HKCategoryType. Actuellement, il n’y a qu’une seule clé pour l’analyse du sommeil.
HKCdaDocument	Contient les informations représentées en XML dans un document d’intégrité du magasin HealthKit.
HKCdaDocumentSample	Contient les informations représentées en XML dans un document d’intégrité du magasin HealthKit.
HKCharacteristicType	HKObjectType qui spécifie un aspect permanent de l’utilisateur.
HKCharacteristicTypeIdentifierExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKCharacteristicTypeIdentifierKey	Définit le nom de constante d’un HKCharacteristicType.
HKClinicalRecord	Un échantillon pour les dossiers cliniques.
HKClinicalType	Type d’échantillon pour un dossier clinique.
HKClinicalTypeIdentifierExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKCorrelation	Corrélation entre deux données de santé (par exemple, la tension artérielle).
HKCorrelationQuery	HKQuery qui retourne uniquement les données qui avaient été stockées avec des corrélations. (Remarque : Les lectures de tension artérielle systolique et diastolique ne sont pas corrélées.)
HKCorrelationType	HKSampleType qui spécifie une corrélation entre deux types de données (par exemple, la tension artérielle).
HKCorrelationTypeIdentifierExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKCorrelationTypeKey	Définit les formes de HKCorrelation.
HKCumulativeQuantitySeriesSample	Série de données cumulatives.
HKDeletedObject	Représente des exemples qui ont été supprimés du magasin.
HKDetailedCdaErrors	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKDevice	Matériel qui génère ou consomme des données HealthKit.
HKDevicePropertyKey	Contient des clés dont les valeurs constantes sont liées aux propriétés d’un HKDevice.
HKDocumentQuery	Requêtes pour les documents dans le magasin HealthKit.
HKDocumentSample	Résumé du document d’intégrité du magasin HealthKit.
HKDocumentType	Contient une constante qui identifie le type de document CDA.
HKDocumentTypeIdentifierExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKErrorCodeExtensions	Méthodes d’extension pour l’énumération HealthKit.HKErrorCode.
HKFhirResource	Représente une ressource FHIR (Fast Healthcare Interoperability Resources).
HKFhirResourceTypeExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKFitzpatrickSkinTypeObject	Contient les données de type skin.
HKHealthStore	MonoTouch.HealthKit.HKHealthStore Connexion à la base de données à l’échelle du système d’informations relatives à l’intégrité.
HKHealthStore.Notifications	Classe qui contient des gestionnaires pour les notifications du magasin du Kit d’intégrité.
HKMetadata	Magasin clé-valeur pour différents types de métadonnées liées à l’intégrité.
HKMetadataKey	Définit les clés dans le HKMetadata dictionnaire clé-valeur.
HKObject	Classe de base sur HKSample, qui définit les données d’échantillonnage.
HKObjectType	Classe de base pour les types de données stockables dans la base de données health Kit.
HKObserverQuery	qui HKQuery s’exécute une fois initialement, puis est exécuté automatiquement lorsque des données pertinentes sont ajoutées à la base de données .
HKPredicateKeyPath	Contient des constantes qui représentent des clés qui identifient les chemins de clé de prédicat pour la sélection des valeurs HealthKit.
HKQuantity	Représente une quantité mesurable d’un certain type d’unité, avec une `double` valeur et un HKUnit type.
HKQuantitySample	HKSample qui a une magnitude (voir Quantity).
HKQuantitySeriesSampleBuilder	Génère des exemples de séries de quantités.
HKQuantitySeriesSampleQuery	Interroge les données de série dans un échantillon de quantité.
HKQuantityType	T:HKSampleType qui représente un échantillon cumulatif ou discret.
HKQuantityTypeIdentifierExtensions	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKQuantityTypeIdentifierKey	Types de HKQuantityType.
HKQuery	Classe de base pour l’interrogation des bases de données health Kit.
HKQueryAnchor	Représente l’exemple le plus récent retourné par une précédente requête d’objet ancré.
HKSample	Mesure des informations sur l’intégrité. Classe de base de HKQuantitySample et HKCategorySample.
HKSampleQuery	HKQuery qui récupère des HKSampleType données de la base de données.
HKSampleType	HKObject qui représente des données échantillonnées à une heure spécifique ou échantillonnées sur une période donnée.
HKSeriesBuilder	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKSeriesSample	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKSeriesType	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKSource	Un fournisseur de données d’intégrité, comme un capteur ou une application particulière.
HKSourceQuery	Classe qui représente une requête pour les données HealthKit.
HKSourceRevision	Encapsule , en ajoutant des HKSourceinformations de version.
HKSourceRevisionInfo	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKStatistics	Fournit des opérations statistiques de base sur les informations d’intégrité.
HKStatisticsCollection	Groupe de statistiques connexes (représentant généralement une série chronologique).
HKStatisticsCollectionQuery	HKQuery qui produit une collection de statistiques (par exemple, le nombre d’étapes par jour pour le mois précédent).
HKStatisticsQuery	qui HKQuery peut calculer des statistiques de base (telles que la somme et la moyenne) sur ses données constituantes.
HKUnit	Définitions et méthodes utilitaires pour manipuler des mesures de masse, de longueur, de volume et d’énergie.
HKWheelchairUseObject	Contient une énumération qui décrit l’utilisation des fauteuils roulants.
HKWorkout	HKSample qui représente un entraînement physique.
HKWorkoutBuilder	Génère une séance d’entraînement à partir de données d’entraînement au fur et à mesure qu’elles sont ajoutées.
HKWorkoutConfiguration	Contient des informations de configuration d’entraînement.
HKWorkoutEvent	Une pause ou une reprise d’une séance d’entraînement.
HKWorkoutRoute	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKWorkoutRouteBuilder	Classe permettant d’ajouter des données géographiques à un entraînement à mesure que l’emplacement de l’utilisateur change.
HKWorkoutRouteQuery	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKWorkoutType	représentant HKSampleType une séance d’entraînement.

Énumérations

HKAuthorizationRequestStatus	Énumère les valeurs qui indiquent quand une application doit demander l’autorisation de l’utilisateur pour l’accès.
HKAuthorizationStatus	Énumère l’autorisation de l’application pour lire ou écrire des données d’intégrité.
HKBiologicalSex	Énumère les sexes biologiques.
HKBloodGlucoseMealTime	Énumère les valeurs qui indiquent si une glycémie a été prise avant ou après un repas.
HKBloodType	Énumère les types de sang connus.
HKBodyTemperatureSensorLocation	Énumère les positions auxquelles un thermomètre prend sa lecture.
HKCategoryTypeIdentifier	Énumère les types de T:HealthKit.HKCategory; Actuellement, il n’existe qu’un seul formulaire (Analyse du sommeil).
HKCategoryValue	Contient une valeur unique qui indique qu’une valeur de catégorie n’est pas applicable à la catégorie.
HKCategoryValueAppleStandHour	Énumère si l’utilisateur s’est tenu ou non pendant une heure.
HKCategoryValueCervicalMucusQuality	Énumère la qualité du mucus cervical de l’utilisateur.
HKCategoryValueMenstrualFlow	Énumère la quantité de flux menstruel.
HKCategoryValueOvulationTestResult	Énumère les résultats d’un test d’ovulation.
HKCategoryValueSleepAnalysis	Énumère les états du sommeil : s’ils sont endormis ou simplement couchés.
HKCharacteristicTypeIdentifier	Énumère les formes de HKCharacteristicType.
HKClinicalTypeIdentifier	Énumère les identificateurs de type d’enregistrement clinique.
HKCorrelationTypeIdentifier	Contient des constantes qui identifient les types de corrélation HealthKit.
HKDocumentTypeIdentifier	Énumère les types de documents HealthKit.
HKErrorCode	Énumère les erreurs courantes commises lors de l’accès aux données d’intégrité.
HKFhirResourceType	Énumère les types FHIR (Fast Healthcare Interoperability Resources).
HKFitzpatrickSkinType	Énumère les types d’apparences à l’aide de l’échelle Fitzpatrick.
HKHeartRateMotionContext	Énumère les niveaux d’activité possibles associés à un échantillon de fréquence cardiaque.
HKHeartRateSensorLocation	Énumère les emplacements auxquels un moniteur de fréquence cardiaque est attaché.
HKInsulinDeliveryReason	Énumère les raisons pour lesquelles l’insuline a été fournie.
HKMetricPrefix	Énumère les préfixes de métrique, par exemple Centi-, Deca-, Deci-. Utilisé avec les méthodes de fabrique de HKUnit.
HKQuantityAggregationStyle	Énumère si un HKQuantityType est une mesure cumulative (par exemple, « énergie active brûlée ») ou une valeur discrète (telle que « teneur en alcool dans le sang »).
HKQuantityTypeIdentifier	Énumère les types de HKQuantityType.
HKQueryOptions	Énumère les options disponibles pour une utilisation avec la GetPredicateForSamples(NSDate, NSDate, HKQueryOptions) méthode .
HKStatisticsOptions	Énumère les options applicables aux HKStatisticsQuery objets et .HKStatisticsCollectionQuery
HKSwimmingStrokeStyle	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKUpdateFrequency	Énumère les fréquences pour la remise en arrière-plan des données (voir EnableBackgroundDelivery(HKObjectType, HKUpdateFrequency, Action<Boolean,NSError>)).
HKVO2MaxTestType	Énumère le processus de test utilisé pour établir VO2 Max.
HKWeatherCondition	Énumère les types météorologiques.
HKWheelchairUse	Énumère les constantes qui décrivent l’utilisation des fauteuils roulants.
HKWorkoutActivityType	Énumère diverses activités qui sont considérées comme des entraînements.
HKWorkoutEventType	Énumère les événements qui peuvent se produire pendant une séance d’entraînement (Pause, Reprise).
HKWorkoutSessionLocationType	Énumère les emplacements d’entraînement.
HKWorkoutSwimmingLocationType	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.

Délégués

HKAnchoredObjectResultHandler	Gestionnaire d’achèvement pour HKAnchoredObjectQuery(HKSampleType, NSPredicate, nuint, nuint, HKAnchoredObjectResultHandler2).
HKAnchoredObjectResultHandler2	Gestionnaire de saisie semi-automatique pour les requêtes d’objet ancré.
HKAnchoredObjectUpdateHandler	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKCorrelationQueryResultHandler	Gestionnaire de saisie semi-automatique pour HKCorrelationQuery.
HKHealthStoreGetRequestStatusForAuthorizationToShareHandler	Gestionnaire à passer à GetRequestStatusForAuthorizationToShare(NSSet<HKSampleType>, NSSet<HKObjectType>, HKHealthStoreGetRequestStatusForAuthorizationToShareHandler).
HKObserverQueryUpdateHandler	Mettez à jour le gestionnaire pour les HKObserverQuery objets.
HKQuantitySeriesSampleBuilderFinishSeriesDelegate	Gestionnaire d’achèvement pour T:HealthKit.HKQuantitySeriesSampleBuilder.FinishSeries.
HKQuantitySeriesSampleQueryQuantityDelegate	Gestionnaire à passer à HKQuantitySeriesSampleQuery(HKQuantitySample, HKQuantitySeriesSampleQueryQuantityDelegate).
HKSampleQueryResultsHandler	Gestionnaire de résultats pour HKSampleQuery.
HKSourceQueryCompletionHandler	Gestionnaire de saisie semi-automatique pour HKSourceQuery.
HKStatisticsCollectionEnumerator	Gestionnaire de délégués pour EnumerateStatistics(NSDate, NSDate, HKStatisticsCollectionEnumerator).
HKStatisticsCollectionQueryInitialResultsHandler	Gestionnaire de résultats pour SetInitialResultsHandler(HKStatisticsCollectionQueryInitialResultsHandler) et SetStatisticsUpdateHandler(HKStatisticsCollectionQueryInitialResultsHandler).
HKStatisticsCollectionQueryStatisticsUpdateHandler	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.
HKStatisticsQueryHandler	Gestionnaire de résultats pour C:HKStatisticsQuery.
HKStoreSampleAddedCallback	Gestionnaire de saisie semi-automatique pour AddSamples(HKSample[], HKWorkout, HKStoreSampleAddedCallback).
HKWorkoutBuilderCompletionHandler	Gestionnaire de saisie semi-automatique pour l’ajout de métadonnées avec HKWorkoutRouteQuery(HKWorkoutRoute, HKWorkoutRouteBuilderDataHandler).
HKWorkoutRouteBuilderAddMetadataHandler	Gestionnaire de saisie semi-automatique pour l’ajout de métadonnées avec HKWorkoutRouteQuery(HKWorkoutRoute, HKWorkoutRouteBuilderDataHandler).
HKWorkoutRouteBuilderDataHandler	L’espace de noms HealthKit fournit un stockage de données sécurisé et la récupération d’informations liées à l’intégrité.

Remarques

L’espace de noms Health Kit, introduit dans iOS 8, permet aux applications d’enregistrer, de suivre et d’accéder aux informations relatives à l’intégrité dans un magasin persistant commun.

Approvisionnement, autorisations et profils

Pour utiliser les services Health Kit, les applications doivent être développées à l’aide d’un « ID d’application explicite » et d’un profil d’approvisionnement qui inclut les autorisations d’ID explicite et de Kit d’intégrité.

En outre, les applications doivent avoir une liste Entitlements.plist qui contient la clé com.apple.developer.healthkit de type Boolean avec une valeur de true.

Au moment de l’exécution, l’application doit demander l’accès aux types spécifiques de données d’intégrité qui l’intéressent. L’utilisateur interagira avec une boîte de dialogue d’autorisations dans l’application Intégrité qui lui permet de contrôler avec précision les informations d’intégrité qu’il autorisera.

var temperatureKey = HKQuantityTypeIdentifierKey.BodyTemperature;
var tempQuantityType = HKObjectType.GetQuantityType (temperatureKey);

var hks = new HKHealthStore ();
var success = await hks.RequestAuthorizationToShareAsync (new NSSet (new [] { tempQuantityType }), new NSSet ());

Le résultat de la méthode T:HealthKit.HKHealthStore.RequestAuthorizationtoShareAsync indique uniquement que l’utilisateur a interagi avec la boîte de dialogue d’autorisations, il n’indique pas si l’utilisateur a autorisé le partage de données. Pour cela, les applications peuvent utiliser la GetAuthorizationStatus méthode :

var access = healthKitStore.GetAuthorizationStatus (HKObjectType.GetQuantityType (HKQuantityTypeIdentifierKey.HeartRate));
if (access.HasFlag (HKAuthorizationStatus.SharingAuthorized)) {
//...etc...

Création et stockage de données

Une fois les autorisations accordées, la création et le stockage de données impliquent de créer un d’un particulier, puis d’appeler HKSample SaveObject ou SaveObjectAsync.HKSampleType

Différences de gestion des exceptions entre les méthodes asynchrones et non asynchrones

La philosophie d’Apple concernant les tentatives de stockage ou de lecture d’informations non autorisées est que ces tentatives ne doivent pas entraîner d’exceptions au runtime. Au lieu de cela, les méthodes telles que RequestAuthorizationToShare M:HealthKit.HKStore.SaveObject* sont définies avec des gestionnaires de rappel d’achèvement qui reçoivent un argument non null NSError en cas d’erreur. Les développeurs d’applications qui utilisent de telles méthodes doivent être particulièrement attentifs à la vérification de la réussite, car il est fort probable que les utilisateurs seront prudents quant à l’accès à leurs données de santé.

En revanche, les versions asynchrones de Xamarin de telles méthodes (telles que M:HealthKit.HKHealthStore.RequestAutorizationToShareAsync* et SaveObjectAsync) lèvent un NSErrorException échec ou si la méthode n’est pas autorisée par l’utilisateur final.

//Apple's philosophy: no exception
var myCurrentTemp = HKQuantity.FromQuantity (HKUnit.DegreeFahrenheit, 98.6);
var tempSample = HKQuantitySample.FromType (tempQuantityType, myCurrentTemp, new NSDate (), new NSDate (), new NSDictionary());

hks.SaveObject(tempSample, (success, error) => {
	if(error != null)
	{
   //...etc...

//Xamarin's philosophy: Lack of permissions raises exception
protected async void StoreAsync(HKHealthStore store, HKQuantitySample sample)
{
	try
	{
		var success = await store.SaveObjectAsync (sample);

	}catch(NSErrorException x)
	{
		Console.WriteLine (x);
	}
}

Il existe plusieurs types de T:HealthKit.HKObjecTypes :

HKCharacteristicType les objets représentent des caractéristiques statiques de l’utilisateur, telles que la date de naissance ou le groupe sanguin (voir HKCharacteristicTypeIdentifierKey), tandis que HKSampleType les objets représentent des données échantillonnées au fil du temps. À partir d’iOS 8, il n’existe qu’un seul type de HKCategorySample, qui est SleepAnalysis. La grande majorité des types de données Health Kit sont définis dans HKQuantityTypeIdentifierKey.

La manipulation d’exemples de données implique à la fois un HKSampleType objet et un HKSample pour transporter les données :

HKQuantitySamples peuvent faire référence à une mesure instantanée, auquel cas leurs propriétés P:HealthKit.HKQuantitySample.StartDate et P:HealthKit.HKQuantitySample.EndDate doivent être définies sur la même valeur. D’autres exemples, tels que le nombre d’étapes, sont mesurés au fil du temps et l’heure de début et de fin doit être définie de manière appropriée.

Les données peuvent être associées à des métadonnées. Il existe un certain nombre de clés de métadonnées prédéfinies dans HKMetadataKey, mais les développeurs d’applications sont encouragés à créer leurs propres clés pour les métadonnées.

Unités de mesure et de conversion

Health Kit prend en charge les unités de mesure dans les catégories de masse, longueur, volume et énergie. Cette prise en charge inclut la conversion de valeurs entre systèmes de mesure (par exemple, si un utilisateur préfère des degrés Fahrenheit, mais a un capteur qui signale ses données en Celsius). Cela est automatiquement pris en charge dans l’application Intégrité, mais des conversions explicites sont également possibles, comme illustré dans l’exemple suivant :

var myFahrenheitTemp = HKQuantity.FromQuantity (HKUnit.DegreeFahrenheit, 98.6);
var myCelsiusTemp = myFahrenheitTemp.GetDoubleValue (HKUnit.DegreeCelsius);

Partager via