HealthKit 네임스페이스

HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.

클래스

HKActivitySummary	특정 날짜에 대한 사용자 활동을 요약합니다.
HKActivitySummaryQuery	과 일치하는 인스턴스를 NSPredicate가져옵니다HKActivitySummary.
HKActivitySummaryType	개체를 읽을 수 있는 권한을 HKActivitySummary 요청하는 데 사용되는 Obect입니다.
HKAnchoredObjectQuery	HKQuery 초기 호출에서 가장 최근의 결과를 반환하고 후속 호출에서 는 초기 호출 후에 추가된 데이터만 반환합니다.
HKBiologicalSexObject	GetBiologicalSex(NSError)에서 반환됩니다.
HKBloodTypeObject	반환 기준 GetBloodType(NSError)
HKCategorySample	HKSample 값이 열거형 형식 중 하나인 입니다.
HKCategoryType	HKSampleType 현재 하나의 형식인 절전 모드 분석만 있는 입니다.
HKCategoryTypeIdentifierExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKCategoryTypeIdentifierKey	를 식별 HKCategoryType할 키를 정의합니다. 현재는 절전 모드 분석을 위한 하나의 키만 있습니다.
HKCdaDocument	HealthKit 저장소 상태 문서의 XML에 표시되는 정보를 포함합니다.
HKCdaDocumentSample	HealthKit 저장소 상태 문서의 XML에 표시되는 정보를 포함합니다.
HKCharacteristicType	HKObjectType 사용자의 영구적인 측면을 지정하는 입니다.
HKCharacteristicTypeIdentifierExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKCharacteristicTypeIdentifierKey	의 상수 이름을 정의합니다 HKCharacteristicType.
HKClinicalRecord	임상 기록에 대한 샘플입니다.
HKClinicalType	임상 기록에 대한 샘플 형식입니다.
HKClinicalTypeIdentifierExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKCorrelation	두 가지 건강 데이터(예: 혈압) 간의 상관 관계입니다.
HKCorrelationQuery	HKQuery 상관 관계로 저장된 데이터만 반환하는 입니다. (참고: 수축기 및 확장기 혈압 수치는 상관 관계가 없습니다.)
HKCorrelationType	HKSampleType 두 가지 유형의 데이터(예: 혈압) 간의 상관 관계를 지정하는 입니다.
HKCorrelationTypeIdentifierExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKCorrelationTypeKey	형식 HKCorrelation을 정의합니다.
HKCumulativeQuantitySeriesSample	누적 데이터 계열입니다.
HKDeletedObject	저장소에서 삭제된 샘플을 나타냅니다.
HKDetailedCdaErrors	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKDevice	HealthKit 데이터를 생성하거나 사용하는 하드웨어입니다.
HKDevicePropertyKey	상수 값이 의 속성과 관련된 키를 보유합니다 HKDevice.
HKDocumentQuery	HealthKit 저장소의 문서에 대한 쿼리입니다.
HKDocumentSample	Abstract HealthKit 저장소 상태 문서입니다.
HKDocumentType	CDA 문서 형식을 식별하는 상수를 포함합니다.
HKDocumentTypeIdentifierExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKErrorCodeExtensions	HealthKit.HKErrorCode 열거형에 대한 확장 메서드입니다.
HKFhirResource	FHIR(Fast Healthcare Interoperability Resources) 리소스를 나타냅니다.
HKFhirResourceTypeExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKFitzpatrickSkinTypeObject	스킨 형식 데이터를 보유합니다.
HKHealthStore	MonoTouch.HealthKit.HKHealthStore 상태 관련 정보의 시스템 전체 데이터베이스에 대한 연결입니다.
HKHealthStore.Notifications	Health Kit 저장소 알림에 대한 처리기가 포함된 클래스입니다.
HKMetadata	다양한 유형의 상태 관련 메타데이터에 대한 키-값 저장소입니다.
HKMetadataKey	키-값 사전에서 HKMetadata 키를 정의합니다.
HKObject	샘플링 데이터를 정의하는 에 HKSample대한 기본 클래스입니다.
HKObjectType	Health Kit 데이터베이스에 저장 가능한 데이터 형식에 대한 기본 클래스입니다.
HKObserverQuery	HKQuery 처음에 한 번 실행된 다음 관련 데이터가 데이터베이스에 추가될 때 자동으로 실행되는 입니다.
HKPredicateKeyPath	HealthKit 값을 선택하기 위한 조건자 키 경로를 식별하는 키를 나타내는 상수를 포함합니다.
HKQuantity	값과 HKUnit 형식을 사용하여 특정 유형의 단위 double 의 측정 가능한 수량을 나타냅니다.
HKQuantitySample	HKSample 크기가 있는 입니다(참조Quantity).
HKQuantitySeriesSampleBuilder	수량 샘플 계열을 빌드합니다.
HKQuantitySeriesSampleQuery	수량 샘플에서 계열 데이터를 쿼리합니다.
HKQuantityType	누적 또는 불연속 샘플을 나타내는 T:HKSampleType 입니다.
HKQuantityTypeIdentifierExtensions	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKQuantityTypeIdentifierKey	형식입니다 HKQuantityType.
HKQuery	Health Kit 데이터베이스를 쿼리하기 위한 기본 클래스입니다.
HKQueryAnchor	이전에 고정된 개체 쿼리에서 반환된 가장 최근 샘플을 나타냅니다.
HKSample	상태 정보의 측정값입니다. HKQuantitySample 및 HKCategorySample에 대한 기본 클래스입니다.
HKSampleQuery	HKQuery 데이터베이스에서 데이터를 검색하는 HKSampleType 입니다.
HKSampleType	HKObject 특정 시간에 샘플링되거나 일정 기간 동안 샘플링되는 데이터를 나타내는 입니다.
HKSeriesBuilder	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKSeriesSample	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKSeriesType	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKSource	특정 센서 또는 애플리케이션과 같은 상태 데이터 공급자입니다.
HKSourceQuery	HealthKit 데이터에 대한 쿼리를 나타내는 클래스입니다.
HKSourceRevision	를 래핑하고 버전 정보를 추가합니다 HKSource.
HKSourceRevisionInfo	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKStatistics	상태 정보에 대한 기본 통계 작업을 제공합니다.
HKStatisticsCollection	관련 통계 그룹(일반적으로 시계열을 나타낸다).
HKStatisticsCollectionQuery	HKQuery 통계 컬렉션을 생성하는 입니다(예: 이전 달의 일별 단계 수).
HKStatisticsQuery	HKQuery 해당 구성 데이터에 대한 기본 통계(예: 합계 및 평균)를 계산할 수 있는 입니다.
HKUnit	질량, 길이, 볼륨 및 에너지의 측정을 조작하기 위한 정의 및 유틸리티 메서드입니다.
HKWheelchairUseObject	휠체어 사용을 설명하는 열거형을 포함합니다.
HKWorkout	HKSample 실제 운동을 나타내는 입니다.
HKWorkoutBuilder	추가되는 운동 데이터에서 운동을 빌드합니다.
HKWorkoutConfiguration	운동 구성 정보를 포함합니다.
HKWorkoutEvent	운동의 일시 중지 또는 재개.
HKWorkoutRoute	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKWorkoutRouteBuilder	사용자의 위치가 변경됨에 따라 운동에 지리적 데이터를 추가하는 클래스입니다.
HKWorkoutRouteQuery	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKWorkoutType	HKSampleType 운동을 나타내는 입니다.

열거형

HKAuthorizationRequestStatus	앱이 액세스에 대한 사용자 권한을 요청해야 하는 시기를 알려주는 값을 열거합니다.
HKAuthorizationStatus	상태 데이터를 읽거나 쓸 수 있는 앱의 권한을 열거합니다.
HKBiologicalSex	생물학적 남녀를 열거합니다.
HKBloodGlucoseMealTime	식사 전후에 혈당 수치를 취했는지 여부를 알려주는 값을 열거합니다.
HKBloodType	알려진 혈액형을 열거합니다.
HKBodyTemperatureSensorLocation	온도계가 판독값을 받는 위치를 열거합니다.
HKCategoryTypeIdentifier	형식을 열거합니다. 현재 하나의 양식(절전 분석)만 있습니다.
HKCategoryValue	범주 값이 범주에 적용되지 않음을 나타내는 단일 값을 포함합니다.
HKCategoryValueAppleStandHour	사용자가 한 시간 동안 서 있는지 여부를 열거합니다.
HKCategoryValueCervicalMucusQuality	사용자의 자궁 경부 점액 품질을 열거합니다.
HKCategoryValueMenstrualFlow	생리 흐름의 양을 열거합니다.
HKCategoryValueOvulationTestResult	배란 테스트의 결과를 열거합니다.
HKCategoryValueSleepAnalysis	잠자는 상태 또는 단지 침대에서 쉬고 있는지 여부를 열거합니다.
HKCharacteristicTypeIdentifier	형식 HKCharacteristicType을 열거합니다.
HKClinicalTypeIdentifier	임상 레코드 형식 식별자를 열거합니다.
HKCorrelationTypeIdentifier	HealthKit 상관 관계 유형을 식별하는 상수를 포함합니다.
HKDocumentTypeIdentifier	HealthKit 문서 형식을 열거합니다.
HKErrorCode	상태 데이터에 액세스할 때 발생하는 일반적인 오류를 열거합니다.
HKFhirResourceType	FHIR(Fast Healthcare Interoperability Resources) 유형을 열거합니다.
HKFitzpatrickSkinType	Fitzpatrick 배율을 사용하여 피부 유형을 열거합니다.
HKHeartRateMotionContext	심박수 샘플과 관련된 가능한 활동 수준을 열거합니다.
HKHeartRateSensorLocation	심박수 모니터가 연결된 위치를 열거합니다.
HKInsulinDeliveryReason	인슐린이 제공된 이유를 열거합니다.
HKMetricPrefix	메트릭 접두사(예: Centi-, Deca-, Deci-)를 열거합니다. 의 HKUnit팩터리 메서드와 함께 사용됩니다.
HKQuantityAggregationStyle	가 누적 측정값인지 HKQuantityType (예: "활성 에너지 소모") 또는 불연속 값(예: "혈중 알코올 함량")을 열거합니다.
HKQuantityTypeIdentifier	형식 HKQuantityType을 열거합니다.
HKQueryOptions	메서드와 함께 사용할 수 있는 옵션을 열거합니다 GetPredicateForSamples(NSDate, NSDate, HKQueryOptions) .
HKStatisticsOptions	및 HKStatisticsCollectionQuery objets에 HKStatisticsQuery 적용 가능한 옵션을 열거합니다.
HKSwimmingStrokeStyle	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKUpdateFrequency	데이터의 백그라운드 배달에 대한 빈도를 열거합니다(참조 EnableBackgroundDelivery(HKObjectType, HKUpdateFrequency, Action<Boolean,NSError>)).
HKVO2MaxTestType	VO2 Max를 설정하는 데 사용되는 테스트 프로세스를 열거합니다.
HKWeatherCondition	날씨 유형을 열거합니다.
HKWheelchairUse	휠체어 사용을 설명하는 상수를 열거합니다.
HKWorkoutActivityType	운동으로 간주되는 다양한 활동을 열거합니다.
HKWorkoutEventType	운동 중에 발생할 수 있는 이벤트를 열거합니다(일시 중지, 다시 시작).
HKWorkoutSessionLocationType	운동 위치를 열거합니다.
HKWorkoutSwimmingLocationType	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.

대리자

HKAnchoredObjectResultHandler	에 대한 완료 처리기입니다 HKAnchoredObjectQuery(HKSampleType, NSPredicate, nuint, nuint, HKAnchoredObjectResultHandler2).
HKAnchoredObjectResultHandler2	고정된 개체 쿼리에 대한 완료 처리기입니다.
HKAnchoredObjectUpdateHandler	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKCorrelationQueryResultHandler	에 대한 완료 처리기입니다 HKCorrelationQuery.
HKHealthStoreGetRequestStatusForAuthorizationToShareHandler	에 전달할 처리기 GetRequestStatusForAuthorizationToShare(NSSet<HKSampleType>, NSSet<HKObjectType>, HKHealthStoreGetRequestStatusForAuthorizationToShareHandler)입니다.
HKObserverQueryUpdateHandler	개체에 대한 HKObserverQuery 업데이트 처리기입니다.
HKQuantitySeriesSampleBuilderFinishSeriesDelegate	T:HealthKit.HKQuantitySeriesSampleBuilder.FinishSeries에 대한 완료 처리기입니다.
HKQuantitySeriesSampleQueryQuantityDelegate	에 전달할 처리기 HKQuantitySeriesSampleQuery(HKQuantitySample, HKQuantitySeriesSampleQueryQuantityDelegate)입니다.
HKSampleQueryResultsHandler	에 대한 결과 처리기입니다 HKSampleQuery.
HKSourceQueryCompletionHandler	에 대한 완료 처리기입니다 HKSourceQuery.
HKStatisticsCollectionEnumerator	에 대한 대리자 처리기입니다 EnumerateStatistics(NSDate, NSDate, HKStatisticsCollectionEnumerator).
HKStatisticsCollectionQueryInitialResultsHandler	및 SetStatisticsUpdateHandler(HKStatisticsCollectionQueryInitialResultsHandler)에 대한 SetInitialResultsHandler(HKStatisticsCollectionQueryInitialResultsHandler) 결과 처리기입니다.
HKStatisticsCollectionQueryStatisticsUpdateHandler	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.
HKStatisticsQueryHandler	C:HKStatisticsQuery에 대한 결과 처리기입니다.
HKStoreSampleAddedCallback	에 대한 완료 처리기입니다 AddSamples(HKSample[], HKWorkout, HKStoreSampleAddedCallback).
HKWorkoutBuilderCompletionHandler	를 사용하여 메타데이터 HKWorkoutRouteQuery(HKWorkoutRoute, HKWorkoutRouteBuilderDataHandler)를 추가하기 위한 완료 처리기입니다.
HKWorkoutRouteBuilderAddMetadataHandler	를 사용하여 메타데이터 HKWorkoutRouteQuery(HKWorkoutRoute, HKWorkoutRouteBuilderDataHandler)를 추가하기 위한 완료 처리기입니다.
HKWorkoutRouteBuilderDataHandler	HealthKit 네임스페이스는 보안 데이터 스토리지를 제공하고 상태 관련 정보를 검색합니다.

설명

iOS 8에 도입된 상태 키트 네임스페이스를 사용하면 애플리케이션에서 상태 관련 정보를 기록, 추적 및 공통 영구 저장소에 액세스할 수 있습니다.

프로비저닝, 권한 및 프로필

Health Kit 서비스를 사용하려면 "명시적 앱 ID"와 명시적 ID 및 상태 키트 권한이 포함된 프로비저닝 프로필을 사용하여 애플리케이션을 개발해야 합니다.

또한 애플리케이션에는 값true이 인 형식 Boolean 의 키가 com.apple.developer.healthkit 포함된 Entitlements.plist가 있어야 합니다.

런타임 시 애플리케이션은 관심 있는 특정 유형의 상태 데이터에 대한 액세스를 요청해야 합니다. 사용자는 상태 앱에서 사용 권한 대화 상자와 상호 작용하여 허용할 상태 정보를 세분화하여 제어할 수 있습니다.

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

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

T:HealthKit.HKHealthStore.RequestAuthorizationtoShareAsync 메서드의 결과는 사용자가 권한 대화 상자와 상호 작용했음을 나타내며 사용자가 데이터 공유를 허용했는지 여부를 나타내지 않습니다. 이를 위해 애플리케이션은 메서드를 사용할 수 있습니다.GetAuthorizationStatus

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

데이터 만들기 및 저장

권한이 부여되면 데이터를 만들고 저장하려면 특정 의 를 HKSample 만든 다음 또는 SaveObjectAsync을 호출 SaveObject 해야 HKSampleType 합니다.

비동기 메서드와 비동기 메서드 간의 예외 처리 차이점

허용되지 않는 정보를 저장하거나 읽으려는 시도에 대한 Apple의 철학은 이러한 시도로 인해 런타임 예외가 발생하지 않아야 한다는 것입니다. 대신 및 M:HealthKit.HKStore.SaveObject*와 같은 RequestAuthorizationToShare 메서드는 오류 발생 시 null NSError 이 아닌 인수를 전달하는 완료 콜백 처리기로 정의됩니다. 이러한 방법을 사용하는 애플리케이션 개발자는 사용자가 자신의 상태 데이터에 액세스하는 데 신중할 가능성이 높기 때문에 성공을 확인하기 위해 특별히 주의해야 합니다.

반면, Xamarin의 비동기 버전의 메서드(예 M:HealthKit.HKHealthStore.RequestAutorizationToShareAsync* 및 SaveObjectAsync)는 실패 시 또는 최종 사용자가 메서드를 허용하지 않는 경우 을 throw NSErrorException 합니다.

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

HealthKit.HKObjecTypes에는 여러 가지 유형이 있습니다.

HKCharacteristicType개체는 생년월일 또는 혈액형과 같은 사용자의 정적 특성을 나타내고HKSampleType(참조HKCharacteristicTypeIdentifierKey) 개체는 시간이 지남에 따라 샘플링되는 데이터를 나타냅니다. iOS 8을 기준으로 의 형식 HKCategorySample은 하나뿐입니다 SleepAnalysis. 대부분의 Health Kit 데이터 형식은 에 HKQuantityTypeIdentifierKey정의되어 있습니다.

데이터 샘플을 조작하려면 개체와 HKSample 를 모두 HKSampleType 사용하여 데이터를 전달합니다.

HKQuantitySamples는 즉각적인 측정을 참조할 수 있습니다. 이 경우 HealthKit.HKQuantitySample.StartDate 및 P:HealthKit.HKQuantitySample.EndDate 속성을 동일한 값으로 설정해야 합니다. 단계 수와 같은 다른 샘플은 시간에 따라 측정되며 시작 및 종료 시간을 적절하게 설정해야 합니다.

데이터에 연결된 메타데이터가 있을 수 있습니다. 에 미리 정의된 메타데이터 키가 HKMetadataKey많이 있지만 애플리케이션 개발자는 메타데이터에 대한 자체 키를 만드는 것이 좋습니다.

측정 및 변환 단위

Health Kit는 질량, 길이, 볼륨 및 에너지 범주의 측정 단위를 지원합니다. 이 지원에는 측정 시스템 간의 값 변환이 포함됩니다(예: 사용자가 화씨도를 선호하지만 데이터를 섭씨로 보고하는 센서가 있는 경우). 이는 상태 앱 내에서 자동으로 지원되지만 다음 예제와 같이 명시적 변환도 가능합니다.

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