First Indicator App

Indicator app is a native LaMetric Time app that is useful for displaying icons, numbers, text and charts that must stay on the device at all times.

There are two ways you can deliver data to the app – push and poll. “Push” means you can send data to the app and it will be delivered immediately. “Poll” app will poll for the data with some predefined time interval.

Push Indicator App

Use “push” communication type when data is not changing too often and you want it to be updated as soon as it changes. Let’s create the simplest indicator app and see how it works.

1. Create Indicator App

Start by logging in to your developer account and creating new indicator app.

../../_images/step1.png

Choose icon for your app. It will represent what we are trying to keep track of.

../../_images/step2.png

You can choose existing one or create icon yourself. It will be available to the whole community.

../../_images/step3.png

Enter initial value that will be displayed by default.

../../_images/step4.png

Choose “Push” communication type as we are going to push data to the app.

../../_images/step5.png

Go to next step by clicking on the “Next” button.

../../_images/step6.png

Now enter the name and description for your app. You’ll find it in Appstore and LaMetric Time app.

../../_images/step7.png

Once app is saved you will be presented with push URL, access token and data format. Now you have all the information to start delivering some data.

2. Publish app and install it to your LaMetric Time

Let’s click that “Publish” button at the top and wait for confirmation email. It should take no longer than two minutes for the e-mail to reach your inbox.

../../_images/step8.png

Install your newly created app to your LaMetric Time device!

../../_images/app-step11.png ../../_images/app-step21.png ../../_images/app-step31.png ../../_images/app-step4.png

At this stage it should be active on LaMetric Time, displaying default value.

../../_images/value-0.jpg

3. Push some data!

Tip

We will be using curl tool to make HTTP requests. While Linux and Mac users have it pre-installed, Windows users may want to download it.

Fortunately, there is curl example already on your app details page. Lets see how it looks in our case.

curl -X POST \
-H "Accept: application/json" \
-H "X-Access-Token: NzM2ZmI3ZTQyZDI0ZDk4OWExNTJmNTc1ZGQ3MzYyMjg2NDkwODA1MDMwODQ0ODAzNjMyNTgxYmI1YmIwYjBiOA==" \
-H "Cache-Control: no-cache" \
-d '{
    "frames": [
        {
            "text": "0",
            "icon": 3219
        }
    ]
}' \
https://developer.lametric.com/api/v1/dev/widget/update/com.lametric.22e45a6407da88c0c938a8aaf8f7406f/1

Note

Don’t forget to replace X-Access-Token and URL with values specific to your app. You can find them on the app details page on “Published V1” tab.

Let’s copy and paste that into terminal app, change value of “text” attribute to “1” and run!

../../_images/term-example1.png

If value has changed - congratulations! You have successfully created your first LaMetric Time app! If it didn’t, make sure X-Access-Token and URL are specific to your app and valid.

../../_images/value-1.jpg

Poll Indicator App

Use “Poll” communication type when data you are trying to display changes often, requires authentication or additional user parameters. In this case indicator app will poll for data by itself with some predefined time interval. To simplify things a little, let’s use DropBox as a backend.

Create Indicator App

Prepare our backend by creating and uploading file named data.json to DropBox with the following contents:

{
    "frames": [
        {
            "icon":3219,
            "text":"2"
        }
    ]
}

Get the link to your data.json file by pressing “Share” button next to it and choosing “Copy Link”.

../../_images/dropbox-data.json.png ../../_images/dropbox-data.json-link1.png ../../_images/dropbox-data.json-link2.png

In our case it should look like this https://www.dropbox.com/s/5rb4l1939ddhvdg/data.json?dl=0. But, to make it work with LaMetric Time link must be direct. To make it direct let’s change dl=0 at the end to dl=1 - https://www.dropbox.com/s/5rb4l1939ddhvdg/data.json?dl=1

Let’s modify our “Push” app we made in previous section and make it poll for the data - just change the “Communication type” switch into “Poll” position.

Insert the link to data.json file into “URL to get data from” text field and choose “Poll frequency” to be set to some reasonable amount of time, for example 30 seconds.

../../_images/step21.png

Publish app and install it to your LaMetric Time

Finally, lets publish our modified app by pressing “UPDATE” button at the top.

Once you received e-mail confirmation that your app is live - re-install it on your LaMetric Time device.

Note

To delete LaMetric Time app, press and hold it’s icon for a second and drop to “Delete” area on top.

Pull some data!

Let’s try to change the number displayed on the device. Modify data.json file and change text value to “3”:

{
    "frames": [
        {
            "icon":"i3219",
            "text":"3"
        }
    ]
}

Save the file and upload it to the DropBox. Within 30 seconds the number will change!

../../_images/step-final.jpg

Congratulations! You have just learned how to create two types of indicator apps for your LaMetric Time!

What next?

To learn more about LaMetric Indicator apps check other tutorials here. Check First Button App section to learn more about Button apps.