• Overview
• Getting Started
• Running Environment
• Sample Code
• Result
• License

The sample code shows how to use the Capture API and Barrier API of HUAWEI Awareness Kit for quick integration.

Introduction of HMS Awareness Kit.

This sample uses the Gradle build system.

First download the demo by cloning this repository or downloading an archived snapshot.

Check whether the Android studio development environment is ready. Open the sample code project directory with file "build.gradle" in Android Studio.

To compile and run sample code , you should create an app in AppGallery Connect, change the sample package name to your app package name, and place the agconnect-services.json file and signing certificate under the app directory. For details, please refer to Preparations.

Android Studio and JDK 1.8 are used for coding.

Run the app generated by the sample code on the device which have installed Huawei Mobile Service(HMS).

The HUAWEI Awareness Kit sample code includes Capture and Barrier API sample code.

Capture APIs can be called to obtain the time, headset, location, activity, ambient light, weather, bluetooth car stereo, and beacon status. Capture APIs allow your app to request the status of a user. For example, the getHeadsetStatus() API can be used to obtain connection status of the headset.

For details about Capture APIs, please visit the References of the Capture APIs.

Barrier APIs can be called to implement awareness of the time, headset, location, activity, ambient light, Bluetooth car stereo, and beacon status. Barrier APIs allow your app to set a series of awareness states. When a user enters a set state, Awareness Kit triggers the corresponding callback to notify the app. For example, the LocationBarrier.enter() API can be used to create a geo-fence.When the user enters the area specified by the geo-fence, Awareness Kit triggers the corresponding callback to notify the app.

For details about Barrier APIs, please visit the References of the Barrier APIs.

Other Awareness Kit API References.

If you want to evaluate more about HMS Core, r/HMSCore on Reddit is for you to keep up with latest news about HMS Core, and to exchange insights with other developers.

If you have questions about how to use HMS samples, try the following options:

• Stack Overflow is the best place for any programming questions. Be sure to tag your question with huawei-mobile-services.
• Huawei Developer Forum HMS Core Module is great for general questions, or seeking recommendations and opinions.

If you run into a bug in our samples, please submit an issue to the Repository. Even better you can submit a Pull Request with a fix.

HUAWEI Awareness Kit sample is licensed under the Apache License, version 2.0.