The Cloud IoT Core Client makes it simple to integrate Android Things with Cloud IoT Core by providing abstractions for all of Cloud IoT Core's device functions:
- Publishing telemetry events
- Publishing device state
- Receiving device configuration from Cloud IoT Core
- Receiving device commands from Cloud IoT Core
The library handles all concurrency so clients can use it in the main thread. It also manages interactions with the Cloud IoT Core MQTT bridge so users don't have to worry about low-level networking protocols.
There are three steps to using this library: set up Cloud IoT Core, download the library, and then start using the library to communicate with Cloud IoT Core.
Follow the instructions on the Cloud IoT Core website to enable the Cloud IoT Core API, create a device registry, and register your device.
Add the following lines to your app's build.gradle:
dependencies {
implementation 'com.google.android.things:cloud-iot-core:1.0.0'
}After Cloud IoT Core is configured, getting your device connected takes only a few lines of code:
// Load the keys used to register this device
KeyPair keys = ...
// Configure Cloud IoT Core project information
ConnectionParams connectionParams = new ConnectionParams.Builder()
.setProjectId("<your Google Cloud project ID>")
.setRegistry("<your Cloud IoT Core registry ID>", "<your registry's cloud region>")
.setDeviceId("<the device's ID in the registry>")
.build();
// Initialize the IoT Core client
IotCoreClient client = new IotCoreClient.Builder()
.setConnectionParams(connectionParams)
.setKeyPair(keys)
.build();
// Connect to Cloud IoT Core
client.connect();
// Start sending data!
client.publishDeviceState("Hello world!\n".getBytes());Check out the Android Things Sensorhub sample app for an example. The library's full documentation is available on the Cloud IoT Core website.
Copyright 2018 Google LLC
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.