HealthKit Spazio dei nomi

Riferimento

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.

Classi

HKActivitySummary	Riepiloga l'attività dell'utente per un giorno specifico.
HKActivitySummaryQuery	Ottiene HKActivitySummary le istanze che corrispondono a un oggetto NSPredicate.
HKActivitySummaryType	Obect utilizzato per richiedere l'autorizzazione per leggere HKActivitySummary gli oggetti.
HKAnchoredObjectQuery	Oggetto HKQuery che nella chiamata iniziale restituisce il risultato più recente e nelle chiamate successive restituisce solo i dati aggiunti dopo la chiamata iniziale.
HKBiologicalSexObject	Classe restituita da GetBiologicalSex(NSError).
HKBloodTypeObject	Restituito da GetBloodType(NSError)
HKCategorySample	Oggetto HKSample il cui valore è uno di un tipo enumerato.
HKCategoryType	Oggetto HKSampleType che attualmente ha una sola forma: analisi sospensione.
HKCategoryTypeIdentifierExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKCategoryTypeIdentifierKey	Definisce le chiavi da identificare HKCategoryType. Attualmente è solo l'unica chiave per l'analisi del sonno.
HKCdaDocument	Contiene le informazioni rappresentate in XML in un documento di integrità dell'archivio HealthKit.
HKCdaDocumentSample	Contiene le informazioni rappresentate in XML in un documento di integrità dell'archivio HealthKit.
HKCharacteristicType	Oggetto HKObjectType che specifica un aspetto permanente dell'utente.
HKCharacteristicTypeIdentifierExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKCharacteristicTypeIdentifierKey	Definisce il nome della costante per un oggetto HKCharacteristicType.
HKClinicalRecord	Campione per le registrazioni cliniche.
HKClinicalType	Tipo di campione per una registrazione clinica.
HKClinicalTypeIdentifierExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKCorrelation	Correlazione tra due dati sanitari (ad esempio, pressione sanguigna).
HKCorrelationQuery	Oggetto HKQuery che restituisce solo i dati archiviati con le correlazioni. Nota: le letture systolic e diastoliche della pressione sanguigna non sono correlate.
HKCorrelationType	Oggetto HKSampleType che specifica una correlazione tra due tipi di dati (ad esempio, pressione sanguigna).
HKCorrelationTypeIdentifierExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKCorrelationTypeKey	Definisce le forme di HKCorrelation.
HKCumulativeQuantitySeriesSample	Serie di dati cumulativi.
HKDeletedObject	Rappresenta gli esempi eliminati dall'archivio.
HKDetailedCdaErrors	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKDevice	Hardware che genera o utilizza i dati di HealthKit.
HKDevicePropertyKey	Contiene chiavi i cui valori costanti sono correlati alle proprietà di un oggetto HKDevice.
HKDocumentQuery	Query per i documenti nell'archivio HealthKit.
HKDocumentSample	Documento di integrità astratto dell'archivio HealthKit.
HKDocumentType	Contiene una costante che identifica il tipo di documento CDA.
HKDocumentTypeIdentifierExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKErrorCodeExtensions	Metodi di estensione per l'enumerazione HealthKit.HKErrorCode.
HKFhirResource	Rappresenta una risorsa FHIR (Fast Healthcare Interoperability Resources).
HKFhirResourceTypeExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKFitzpatrickSkinTypeObject	Contiene dati di tipo skin.
HKHealthStore	MonoTouch.HealthKit.HKHealthStore Una connessione al database a livello di sistema di informazioni correlate all'integrità.
HKHealthStore.Notifications	Classe che contiene i gestori per le notifiche dell'archivio di Health Kit.
HKMetadata	Archivio chiave-valore per vari tipi di metadati correlati all'integrità.
HKMetadataKey	Definisce le chiavi nel HKMetadata dizionario chiave-valore.
HKObject	Classe di base su HKSample, che definisce i dati di campionamento.
HKObjectType	Classe di base per i tipi di dati storable nel database di Health Kit.
HKObserverQuery	Oggetto HKQuery che viene eseguito una volta inizialmente e quindi viene eseguito automaticamente quando i dati pertinenti vengono aggiunti al database .
HKPredicateKeyPath	Contiene costanti che rappresentano chiavi che identificano i percorsi delle chiavi del predicato per la selezione dei valori healthKit.
HKQuantity	Rappresenta una quantità misurabile di un determinato tipo di unità, con un `double` valore e un HKUnit tipo.
HKQuantitySample	Oggetto HKSample con una grandezza (vedere Quantity).
HKQuantitySeriesSampleBuilder	Compila una serie di esempi di quantità.
HKQuantitySeriesSampleQuery	Esegue una query su dati di serie in un campione di quantità.
HKQuantityType	:HKSampleType che rappresenta un campione cumulativo o discreto.
HKQuantityTypeIdentifierExtensions	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKQuantityTypeIdentifierKey	Tipi di HKQuantityType.
HKQuery	Classe di base per l'esecuzione di query sui database di Health Kit.
HKQueryAnchor	Rappresenta l'esempio più recente restituito da una query oggetto ancorata precedente.
HKSample	Misurazione delle informazioni sull'integrità. Classe di base per HKQuantitySample e HKCategorySample.
HKSampleQuery	Oggetto HKQuery che recupera i HKSampleType dati dal database.
HKSampleType	Oggetto HKObject che rappresenta i dati campionati in un momento specifico o campionati in un periodo di tempo.
HKSeriesBuilder	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKSeriesSample	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKSeriesType	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKSource	Provider di dati sull'integrità, ad esempio un sensore o un'applicazione specifica.
HKSourceQuery	Classe che rappresenta una query per i dati di HealthKit.
HKSourceRevision	Esegue il HKSourcewrapping di , aggiungendo informazioni sulla versione.
HKSourceRevisionInfo	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKStatistics	Fornisce operazioni statistiche di base sulle informazioni sull'integrità.
HKStatisticsCollection	Un gruppo di statistiche correlate (in genere che rappresenta una serie temporale).
HKStatisticsCollectionQuery	Oggetto HKQuery che produce una raccolta di statistiche (ad esempio, numero di passaggi al giorno per il mese precedente).
HKStatisticsQuery	Oggetto HKQuery che può calcolare le statistiche di base (ad esempio la somma e la media) sui dati costitutivi.
HKUnit	Definizioni e metodi di utilità per modificare le misurazioni di massa, lunghezza, volume e energia.
HKWheelchairUseObject	Contiene un'enumerazione che descrive l'uso della sedia a rotelle.
HKWorkout	Oggetto HKSample che rappresenta un allenamento fisico.
HKWorkoutBuilder	Compila un allenamento dai dati di allenamento quando viene aggiunto.
HKWorkoutConfiguration	Contiene informazioni sulla configurazione dell'allenamento.
HKWorkoutEvent	Pausa o ripresa di un allenamento.
HKWorkoutRoute	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKWorkoutRouteBuilder	Classe per l'aggiunta di dati geografici a un allenamento durante la modifica della posizione dell'utente.
HKWorkoutRouteQuery	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKWorkoutType	Oggetto HKSampleType che rappresenta un allenamento.

Enumerazioni

HKAuthorizationRequestStatus	Enumera i valori che indicano quando un'app deve richiedere l'autorizzazione utente per l'accesso.
HKAuthorizationStatus	Enumera l'autorizzazione dell'app per leggere o scrivere dati di integrità.
HKBiologicalSex	Enumera i sessi biologici.
HKBloodGlucoseMealTime	Enumera i valori che indicano se un livello di glucosio nel sangue è stato preso prima o dopo un pasto.
HKBloodType	Enumera i tipi di sangue noti.
HKBodyTemperatureSensorLocation	Enumera le posizioni in cui un termometro prende la lettura.
HKCategoryTypeIdentifier	Enumera i tipi di T:HealthKit.HKCategory; attualmente è presente solo il formato (Analisi sospensione).
HKCategoryValue	Contiene un singolo valore che indica che un valore di categoria non è applicabile alla categoria.
HKCategoryValueAppleStandHour	Enumera se l'utente è rimasto o meno durante un'ora.
HKCategoryValueCervicalMucusQuality	Enumera la qualità del mucus cervicale dell'utente.
HKCategoryValueMenstrualFlow	Enumera la quantità di flusso mestruale.
HKCategoryValueOvulationTestResult	Enumera i risultati di un test di ovulazione.
HKCategoryValueSleepAnalysis	Enumera gli stati del sonno: che siano addormentati o semplicemente riposati a letto.
HKCharacteristicTypeIdentifier	Enumera le forme di HKCharacteristicType.
HKClinicalTypeIdentifier	Enumera gli identificatori del tipo di record clinici.
HKCorrelationTypeIdentifier	Contiene costanti che identificano i tipi di correlazione HealthKit.
HKDocumentTypeIdentifier	Enumera i tipi di documento HealthKit.
HKErrorCode	Enumera gli errori comuni generati durante l'accesso ai dati di integrità.
HKFhirResourceType	Enumera i tipi FHIR (Fast Healthcare Interoperability Resources).
HKFitzpatrickSkinType	Enumera i tipi di interfaccia usando la scala Fitzpatrick.
HKHeartRateMotionContext	Enumera i possibili livelli di attività associati a un campione di frequenza cardiaca.
HKHeartRateSensorLocation	Enumera le posizioni in cui è collegato un monitoraggio della frequenza cardiaca.
HKInsulinDeliveryReason	Enumera i motivi per cui è stata fornita l'insulina.
HKMetricPrefix	Enumera i prefissi delle metriche, ad esempio Centi-, Deca-, Deci-. Usato con i metodi factory di HKUnit.
HKQuantityAggregationStyle	Enumera se un HKQuantityType oggetto è una misura cumulativa (ad esempio, "energia attiva bruciata") o un valore discreto ,ad esempio "contenuto di alcol nel sangue".
HKQuantityTypeIdentifier	Enumera i tipi di HKQuantityType.
HKQueryOptions	Enumera le opzioni disponibili per l'uso con il GetPredicateForSamples(NSDate, NSDate, HKQueryOptions) metodo .
HKStatisticsOptions	Enumera le opzioni applicabili a HKStatisticsQuery e HKStatisticsCollectionQuery oggetti.
HKSwimmingStrokeStyle	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKUpdateFrequency	Enumera le frequence per il recapito in background dei dati (vedere EnableBackgroundDelivery(HKObjectType, HKUpdateFrequency, Action<Boolean,NSError>)).
HKVO2MaxTestType	Enumera il processo di test usato per stabilire VO2 Max.
HKWeatherCondition	Enumera i tipi di meteo.
HKWheelchairUse	Enumera costanti che descrivono l'uso della sedia a rotelle.
HKWorkoutActivityType	Enumera varie attività considerate allenamenti.
HKWorkoutEventType	Enumera gli eventi che possono verificarsi durante un allenamento (Pausa, Ripresa).
HKWorkoutSessionLocationType	Enumera le posizioni di allenamento.
HKWorkoutSwimmingLocationType	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.

Delegati

HKAnchoredObjectResultHandler	Gestore di completamento per HKAnchoredObjectQuery(HKSampleType, NSPredicate, nuint, nuint, HKAnchoredObjectResultHandler2).
HKAnchoredObjectResultHandler2	Gestore di completamento per le query oggetto ancorate.
HKAnchoredObjectUpdateHandler	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKCorrelationQueryResultHandler	Gestore di completamento per HKCorrelationQuery.
HKHealthStoreGetRequestStatusForAuthorizationToShareHandler	Gestore da passare a GetRequestStatusForAuthorizationToShare(NSSet<HKSampleType>, NSSet<HKObjectType>, HKHealthStoreGetRequestStatusForAuthorizationToShareHandler).
HKObserverQueryUpdateHandler	Gestore di aggiornamento per HKObserverQuery gli oggetti .
HKQuantitySeriesSampleBuilderFinishSeriesDelegate	Gestore di completamento per T:HealthKit.HKQuantitySeriesSampleBuilder.FinishSeries.
HKQuantitySeriesSampleQueryQuantityDelegate	Gestore da passare a HKQuantitySeriesSampleQuery(HKQuantitySample, HKQuantitySeriesSampleQueryQuantityDelegate).
HKSampleQueryResultsHandler	Gestore dei risultati per HKSampleQuery.
HKSourceQueryCompletionHandler	Gestore di completamento per HKSourceQuery.
HKStatisticsCollectionEnumerator	Gestore delegato per EnumerateStatistics(NSDate, NSDate, HKStatisticsCollectionEnumerator).
HKStatisticsCollectionQueryInitialResultsHandler	Gestore risultati per SetInitialResultsHandler(HKStatisticsCollectionQueryInitialResultsHandler) e SetStatisticsUpdateHandler(HKStatisticsCollectionQueryInitialResultsHandler).
HKStatisticsCollectionQueryStatisticsUpdateHandler	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.
HKStatisticsQueryHandler	Gestore dei risultati per .
HKStoreSampleAddedCallback	Gestore di completamento per AddSamples(HKSample[], HKWorkout, HKStoreSampleAddedCallback).
HKWorkoutBuilderCompletionHandler	Gestore di completamento per l'aggiunta di metadati con HKWorkoutRouteQuery(HKWorkoutRoute, HKWorkoutRouteBuilderDataHandler).
HKWorkoutRouteBuilderAddMetadataHandler	Gestore di completamento per l'aggiunta di metadati con HKWorkoutRouteQuery(HKWorkoutRoute, HKWorkoutRouteBuilderDataHandler).
HKWorkoutRouteBuilderDataHandler	Lo spazio dei nomi HealthKit fornisce un archivio dati sicuro e il recupero di informazioni correlate all'integrità.

Commenti

Lo spazio dei nomi Health Kit, introdotto in iOS 8, consente alle applicazioni di registrare, tenere traccia e accedere alle informazioni correlate all'integrità in un archivio permanente comune.

Provisioning, autorizzazioni e profili

Per usare i servizi Health Kit, le applicazioni devono essere sviluppate usando un "ID app esplicito" e un profilo di provisioning che include le autorizzazioni di ID esplicito e Health Kit.

Inoltre, le applicazioni devono avere un oggetto Entitlements.plist contenente la chiave com.apple.developer.healthkit di tipo Boolean con un valore di true.

In fase di esecuzione, l'applicazione deve richiedere l'accesso ai tipi specifici di dati di integrità in cui è interessato. L'utente interagisce con una finestra di dialogo delle autorizzazioni nell'app Integrità che consente il controllo con granularità fine sulle informazioni sull'integrità consentite.

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

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

Il risultato del metodo indica solo che l'utente ha interagito con la finestra di dialogo delle autorizzazioni, non indica se l'utente ha consentito alcuna condivisione dati. A tale scopo, le applicazioni possono usare il GetAuthorizationStatus metodo:

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

Creazione e archiviazione dei dati

Dopo aver concesso le autorizzazioni, la creazione e l'archiviazione dei dati comporta la creazione di un HKSample determinato HKSampleType oggetto e quindi la chiamata SaveObject o SaveObjectAsync.

Differenze di gestione delle eccezioni tra metodi asincroni e non asincroni

La filosofia di Apple riguardo ai tentativi di archiviare o leggere informazioni non consentite è che tali tentativi non devono causare eccezioni di runtime. Invece, i metodi come RequestAuthorizationToShare e * vengono definiti con gestori di callback di completamento passati a un argomento non Null NSError nel caso di un errore. Gli sviluppatori di applicazioni che usano tali metodi devono prestare particolare attenzione alla verifica dell'esito positivo, poiché è altamente probabile che gli utenti saranno cauti sull'accesso ai dati di integrità.

Al contrario, le versioni asincrone di tali metodi (ad esempio * e SaveObjectAsync) genereranno un NSErrorException errore o se il metodo non è consentito dall'utente finale.

//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);
	}
}

Esistono diversi tipi di s:

HKCharacteristicType gli oggetti rappresentano caratteri statici dell'utente, ad esempio la data di nascita o il tipo di sangue (vedere HKCharacteristicTypeIdentifierKey), mentre HKSampleType gli oggetti rappresentano i dati campionati nel tempo. A partire da iOS 8, esiste solo un tipo di HKCategorySample, che è SleepAnalysis. La maggior parte dei tipi di dati di Health Kit è definita in HKQuantityTypeIdentifierKey.

La modifica degli esempi di dati implica sia un oggetto che un HKSampleType HKSample oggetto per trasportare i dati:

HKQuantitySamples può fare riferimento a una misurazione istantanea, nel qual caso le proprietà HealthKit.HKQuantitySample.StartDate e P:HealthKit.HKQuantitySample.EndDate.EndDate devono essere impostate sullo stesso valore. Altri esempi, ad esempio il conteggio dei passaggi, vengono misurati nel tempo e l'ora di inizio e fine devono essere impostate in modo appropriato.

I dati possono avere metadati associati. Esistono diverse chiavi di metadati predefinite in HKMetadataKey, ma gli sviluppatori di applicazioni sono invitati a creare anche le proprie chiavi per i metadati.

Unità di misura e conversione

Health Kit supporta unità di misura nelle categorie di massa, lunghezza, volume ed energia. Questo supporto include la conversione dei valori tra i sistemi di misurazione, ad esempio se un utente preferisce gradi Fahrenheit, ma ha un sensore che segnala i dati in Celsius. Questa operazione è supportata automaticamente nell'app Integrità, ma sono anche possibili conversioni esplicite, come illustrato nell'esempio seguente:

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