IoT Hub SDKs (Пакеты SDK для Центра Интернета вещей)

В следующих таблицах перечислены различные пакеты SDK, которые можно использовать для создания решений Интернета вещей.

Пакеты SDK для устройств

Пакеты SDK для устройств Центра Интернета вещей Microsoft Azure содержат код, упрощающий построение приложений, которые подключаются к службам Центра Интернета вещей и управляются с помощью этих служб. Эти пакеты SDK могут работать на обычном вычислительном устройстве на основе MPU, например ПК, планшете, смартфоне или Raspberry Pi. Пакеты SDK поддерживают разработку на языке C и современных управляемых языках, включая C#, Node.JS, Python и Java.

Пакеты SDK доступны на нескольких языках, что позволяет выбрать наиболее подходящий вариант для ваших команды и сценария.

Язык Пакет Оригинал Краткие руководства Примеры Справочные материалы
.NET NuGet GitHub Подключение Центр Интернета вещей Примеры Справочные материалы
Python pip GitHub Подключение Центр Интернета вещей Примеры Справочные материалы
Node.js npm  GitHub Подключение Центр Интернета вещей Примеры Справочные материалы
Java Maven GitHub Подключение Центр Интернета вещей Примеры Справочные материалы
C Пакеты GitHub Подключение Центр Интернета вещей Примеры Справочные материалы

Пакет SDK для устройств Java включает примеры для Android.

Пакет SDK для устройств C содержит примеры для iOS, использующих CocoaPods.

Предупреждение

Пакет SDK Для Azure IoT C не подходит для внедренных приложений из-за ее модели управления памятью и потоков. Сведения о параметрах пакета SDK для внедренных устройств см. в пакетах SDK для внедренных устройств.

Используйте пакеты SDK для устройств для разработки кода для запуска на устройствах Интернета вещей, которые подключаются к Центр Интернета вещей или IoT Central.

Дополнительные сведения об использовании пакетов SDK для устройств см. в статье "Что такое разработка устройств и приложений Azure IoT?".

Пакеты SDK для встраиваемых устройств

Эти пакеты SDK разработаны и созданы для работы на устройствах с ограниченными объемом вычислительных ресурсов и ресурсов памяти. Они реализуются с помощью языка C.

Пакеты SDK для внедренных устройств доступны для нескольких операционных систем , которые обеспечивают гибкость, чтобы выбрать наиболее подходящий сценарий.

ОСРВ SDK Оригинал Примеры Справочные материалы
Eclipse ThreadX ПО промежуточного слоя ОСРВ Azure GitHub Краткие руководства Справочные материалы
FreeRTOS ПО промежуточного слоя FreeRTOS GitHub Примеры Справочные материалы
Компьютер без операционной системы Пакет SDK Azure для Embedded C GitHub Примеры Справочные материалы

Используйте пакеты SDK для внедренных устройств для разработки кода для запуска на устройствах Интернета вещей, которые подключаются к Центр Интернета вещей или IoT Central.

Дополнительные сведения об использовании внедренных пакетов SDK для устройств см . в сценариях использования пакета SDK для C и внедренного пакета SDK для C.

Жизненный цикл и поддержка пакета SDK для устройств

В этом разделе приведены сведения о жизненном цикле пакета SDK для устройств Интернета вещей Azure и политике поддержки. Дополнительные сведения см. в статье о жизненном цикле и политике поддержки пакета SDK Azure.

Жизненный цикл пакета

Пакеты выпускаются в следующих категориях. Каждая категория имеет определенную структуру поддержки.

  1. Бета-версия — также называется предварительным просмотром или кандидатом на выпуск. Доступно для ранних целей доступа и обратной связи и не рекомендуется использовать в рабочей среде. Поддержка предварительной версии ограничена проблемами GitHub. Предварительные версии обычно живут менее шести месяцев, после чего они либо устарели, либо выпущены как активные.

  2. Активный — общедоступная и полностью поддерживаемая, получает новые обновления компонентов, а также исправления ошибок и безопасности. Мы рекомендуем клиентам использовать последнюю версию, так как эта версия получает исправления и обновления.

  3. Устаревший — заменен более недавним выпуском. Нерекомендуется одновременно с тем, что новый выпуск становится активным. Устаревшие выпуски устраняют самые критические исправления ошибок и исправления безопасности в течение еще 12 месяцев.

Поддержка

Если при использовании пакетов SDK Для Интернета вещей Azure возникают проблемы, можно получить поддержку несколькими способами:

  • Отчеты об ошибках. Все клиенты могут сообщать об ошибках на странице проблем для репозитория GitHub, связанного с соответствующим пакетом SDK.

  • Группа поддержки клиентов Майкрософт. Пользователи, у которых есть план поддержки, могут привлечь службу поддержки Майкрософт, создав запрос в службу поддержки непосредственно из портал Azure.

Пакеты SDK для службы Центра Интернета вещей

Пакеты SDK для службы Интернета вещей Azure содержат код, который облегчает создание приложений, взаимодействующих непосредственно с Центром Интернета вещей, для управления устройствами и безопасностью.

Платформа Пакет Репозиторий кода Примеры Справочные материалы
.NET NuGet GitHub Примеры Справочные материалы
Java Maven GitHub Примеры Справочные материалы
Узел npm GitHub Примеры Справочные материалы
Python pip GitHub Примеры Справочные материалы

Дополнительные сведения об использовании пакетов SDK службы для взаимодействия с устройствами через Центр Интернета вещей см. в руководстве разработчика самонастраивающийся службы Интернета вещей.

пакеты SDK для управления Центр Интернета вещей

Пакеты SDK для управления Центр Интернета вещей помогают создавать внутренние приложения, которые управляют центрами Интернета вещей в подписке Azure.

Платформа Пакет Репозиторий кода Справочные материалы
.NET NuGet GitHub Справочные материалы
Java Maven GitHub Справочные материалы
Node.js npm GitHub Справочные материалы
Python pip GitHub Справочные материалы

К альтернативным пакетам SDK для управления относятся Azure CLI, PowerShell и REST API.

Пакеты SDK для устройств DPS

Пакеты SDK для устройств DPS предоставляют реализации API регистрации и других устройств, которые вызываются устройствами для подготовки через DPS. Пакеты SDK для устройств могут работать на общих вычислительных устройствах на основе MPU, таких как компьютер, планшет, смартфон или Raspberry Pi. Пакеты SDK поддерживают разработку на языке C и современных управляемых языках, включая C#, Node.JS, Python и Java.

Платформа Пакет Репозиторий кода Примеры Быстрое начало Справочные материалы
.NET NuGet GitHub Примеры Краткое руководство Справочные материалы
О apt-get, MBED, Arduino IDE или iOS GitHub Примеры Краткое руководство Справочные материалы
Java Maven GitHub Примеры Краткое руководство Справочные материалы
Node.js npm GitHub Примеры Краткое руководство Справочные материалы
Python pip GitHub Примеры Краткое руководство Справочные материалы

Предупреждение

Указанный выше пакет SDK для Cне подходит для встраиваемых приложений из-за способа управления памятью и потоковой модели. Дополнительные сведения о встраиваемых устройствах см. в разделе о пакетах SDK для встраиваемых устройств.

Пакеты SDK для внедренных устройств DPS

Эти пакеты SDK разработаны и созданы для работы на устройствах с ограниченными объемом вычислительных ресурсов и ресурсов памяти. Они реализуются с помощью языка C.

ОСРВ SDK Оригинал Примеры Справочные материалы
Eclipse ThreadX ПО промежуточного слоя ОСРВ Azure GitHub Краткие руководства Справочные материалы
FreeRTOS ПО промежуточного слоя FreeRTOS GitHub Примеры Справочные материалы
Компьютер без операционной системы Пакет SDK Azure для Embedded C GitHub Примеры Справочные материалы

Узнайте больше об пакетах SDK для устройств и внедренных устройств в пакетах SDK для Интернета вещей.

Пакеты SDK для службы DPS

Пакеты SDK службы DPS помогают создавать внутренние приложения для управления регистрациями и записями регистрации в экземплярах DPS.

Платформа Пакет Репозиторий кода Примеры Быстрое начало Справочные материалы
.NET NuGet GitHub Примеры Краткое руководство Справочные материалы
Java Maven GitHub Примеры Краткое руководство Справочные материалы
Node.js npm GitHub Примеры Краткое руководство Справочные материалы

Пакеты SDK для управления DPS

Пакеты SDK для управления DPS помогают создавать внутренние приложения, которые управляют экземплярами DPS и их метаданными в подписке Azure.

Платформа Пакет Репозиторий кода Справочные материалы
.NET NuGet GitHub Справочные материалы
Java Maven GitHub Справочные материалы
Node.js npm GitHub Справочные материалы
Python pip GitHub Справочные материалы

API плоскости управления Azure Digital Twins

API уровня управления — это интерфейсы API ARM, используемые для управления экземпляром Azure Digital Twins в целом, поэтому они охватывают такие операции, как создание или удаление всего экземпляра. Они также используются для создания и удаления конечных точек.

Чтобы вызвать API напрямую, обратитесь к последней папке Swagger в репозитории Swagger уровня управления. В эту папку также входит папка примеров, в которых показано использование.

Ниже приведены пакеты SDK, доступные в настоящее время для API плоскости управления Azure Digital Twins.

Язык пакета SDK Ссылка на пакет Справочная документация Исходный код
.NET (C#) Azure.ResourceManager.DigitalTwins в NuGet Справочник по пакету SDK Для Azure DigitalTwins для .NET Клиентская библиотека управления Microsoft Azure Digital Twins для .NET на GitHub
Java azure-resourcemanager-digitaltwins в Maven Справочник по управлению ресурсами — Digital Twins Клиентская библиотека Azure Resource Manager AzureDigitalTwins для Java на GitHub
JavaScript Клиентская библиотека AzureDigitalTwinsManagement для JavaScript в npm Клиентская библиотека AzureDigitalTwinsManagement для JavaScript на GitHub
Python azure-mgmt-digitaltwins в PyPI Пакет SDK Microsoft Azure для Python на GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt Пакет SDK Azure для Go на GitHub

API плоскости данных Azure Digital Twins

API плоскости данных — это API-интерфейсы Azure Digital Twins, используемые для управления элементами в вашем экземпляре Azure Digital Twins. К ним относятся такие операции, как создание маршрутов, отправка моделей, создание связей и управление двойниками. Их можно разделить на следующие категории:

  • DigitalTwinModels — Категория DigitalTwinModels содержит API для управления моделями в экземпляре Azure Digital Twins. К действиям управления относятся передача, проверка, извлечение и удаление моделей, созданных в DTDL.
  • DigitalTwins — Категория DigitalTwins содержит API, которые позволяют разработчикам создавать, изменять и удалять цифровые двойники и их связи в экземпляре Azure Digital Twins.
  • Query— Категория "Запрос" позволяет разработчикам находить наборы цифровых двойников в графе двойников между связями.
  • Event Routes — Категория "Маршруты событий" содержит API-интерфейсы для маршрутизации данных через систему и подчиненные службы.
  • Import Jobs — API импорта заданий позволяет управлять длительным асинхронным действием для импорта моделей, двойников и связей в массовом режиме.
  • Delete Jobs — API удаления заданий позволяет управлять длительным асинхронным действием для удаления всех моделей, двойников и связей в экземпляре.

Чтобы вызвать API напрямую, обратитесь к последней папке Swagger в репозитории Swagger плоскости данных. В эту папку также входит папка примеров, в которых показано использование. Вы также можете просмотреть справочную документацию по API плоскости данных.

Ниже приведены пакеты SDK, доступные в настоящее время для API плоскости данных Azure Digital Twins.

Язык пакета SDK Ссылка на пакет Справочная документация Исходный код
.NET (C#) Azure.DigitalTwins.Core в NuGet Справочник по клиентской библиотеке Azure IoT Digital Twins для .NET Клиентская библиотека Azure IoT Digital Twins для .NET на GitHub
Java com.azure:azure-digitaltwins-core в Maven Справочник по пакету SDK Для Azure Digital Twins для Java Клиентская библиотека Azure IoT Digital Twins для Java на GitHub
JavaScript Клиентская библиотека Azure Digital Twins Core для JavaScript в npm Reference for @azure/digital-twins-core Клиентская библиотека Azure Digital Twins Core для JavaScript на GitHub
Python Клиентская библиотека Azure Digital Twins Core для Python в PyPI Справочник по azure-digitaltwins-core Клиентская библиотека Azure Digital Twins Core для Python на GitHub

Следующие шаги

Ниже приведены следующие шаги.