Have ideas to improve npm?Join in the discussion! »

    This package has been deprecated

    Author message:

    Incompatible beta test release - should not be used.

    azure-iot-digitaltwins-service
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.0-pnp-refresh.3 • Public • Published

    Azure IoT Digital Twins Client Library

    PREVIEW - WILL LIKELY HAVE BREAKING CHANGES This client library lets you connect to your Azure IoT Hub and manage your Digital Twins. It complements the azure-iothub package that covers the initial set of Azure IoT Hub APIs (identity registry, service client, etc)

    The Azure IoT Digital Twins Service SDK for Node.js helps you build applications that interact with your twin enabled devices and manage their twin document.

    npm version

    Prerequisites

    You need to install the Node.js JavaScript runtime environment to run the Azure IoT JavaScript Service Client SDK on your platform. To check if Node.js supports your platform (OS), verify that an install package is available on the Node.js download page.

    npm is a command-line package manager that is installed with Node.js is installed, and will be used to install Azure IoT node.js client side SDK.

    Installation

    npm install azure-iot-digitaltwins-service to get the latest version.

    Features

    • Get the twin of an existing device
    • Get a single interface instance of an existing device digital twin
    • Get a model from the Model Repository
    • Update digital twin of an existing device
    • Update a single property of an existing digital twin
    • Invoke a command on a device

    How to use the Azure IoT service SDK for Node.js

    Once you have installed the package as indicated above, you can start using the features of the Digital Twins Service SDK in your code. Below is a code snippet showing how to create a Service Client and get the twin document of a device:

    Note that for this sample to work, you will need to setup your IoT hub and retrieve credentials for the service app.

    const IoTHubTokenCredentials = require('azure-iot-digitaltwins-service').IoTHubTokenCredentials;
    const DigitalTwinServiceClient = require('azure-iot-digitaltwins-service').DigitalTwinServiceClient;
    const { inspect } = require('util');
     
    // Preconditions:
    // - Environment variables have to be set
    // - Twin enabled device must exist on the ADT hub
    async function main() {
      const deviceId = process.env.IOTHUB_DEVICE_ID;
      const connString = process.env.IOTHUB_CONNECTION_STRING;
     
      // Create digital twin service client
      const credentials = new IoTHubTokenCredentials(connString);
      const dtServiceclient = new DigitalTwinServiceClient(credentials);
     
      // Get digital twin and retrieve the modelId from it
      const digitalTwin = await dtServiceclient.getDigitalTwin(deviceId);
     
      console.log(inspect(digitalTwin));
    };
     
    main().catch((err) => {
      console.log('error code: ', err.code);
      console.log('error message: ', err.message);
      console.log('error stack: ', err.stack);
    });

    Check out the samples for details on the various features of the Service SDK

    Read more

    Directory structure

    Digital Twins Service SDK folders:

    /digitaltwins/service/devdoc

    Development requirements documentation

    /digitaltwins/service/src

    Code for the library

    digitaltwins/samples/service

    Set of simple samples showing how to use the features of the Digital Twin Service SDK

    /digitaltwins/service/test

    Test files

    Install

    npm i azure-iot-digitaltwins-service

    DownloadsWeekly Downloads

    388

    Version

    1.0.0-pnp-refresh.3

    License

    MIT

    Unpacked Size

    587 kB

    Total Files

    125

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar