Uso del SDK de IoT Platform para .NET - IoT Platform - Centro de documentación de Alibaba Cloud

IoT Platform proporciona a los desarrolladores un SDK para .NET. Este tema describe cómo instalar y configurar el SDK de IoT Platform para .NET, así como utilizarlo para invocar las operaciones de la API de IoT Platform.

Instalación del SDK de IoT Platform para .NET

Instale los entornos de desarrollo de .NET.
El SDK de IoT Platform para .NET es compatible con los siguientes entornos de desarrollo:
- .NET Framework 4.5 y versiones posteriores
- .NET Standard 2.0 y versiones posteriores
- C# 4.0 y versiones posteriores
- Visual Studio 2010 y versiones posteriores
Instale el SDK de IoT Platform para .NET mediante el administrador de paquetes NuGet.

En este ejemplo se utiliza Visual Studio.
1. En el panel Solution Explorer de Visual Studio, haga clic derecho en su proyecto y seleccione Manage NuGet Packages.
2. En el panel NuGet Package Manager, haga clic en Browse.
3. En la pestaña Browse, introduzca aliyun-net-sdk en el cuadro de búsqueda y seleccione el paquete aliyun-net-sdk-iot proporcionado por Alibaba Cloud.
4. Haga clic en Install.

Inicialización del SDK de IoT Platform para C++

El siguiente código muestra un ejemplo de cómo inicializar el SDK para invocar una API en la región China (Shanghai).

Cree el objeto clientProfile para almacenar la información de inicialización del SDK. A continuación, cree la instancia del cliente a partir de DefaultAcsClient. Utilice el método DefaultAcsClient(clientProfile) para cargar la información de inicialización del SDK.

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;

string accessKeyId = Environment.GetEnvironmentVariable("ALIYUN_ACCESS_KEY_ID");
string accessKeySecret = Environment.GetEnvironmentVariable("ALIYUN_ACCESS_KEY_SECRET");

IClientProfile clientProfile = DefaultProfile.GetProfile("cn-shanghai", accessKeyId, accessKeySecret);
DefaultAcsClient client = new DefaultAcsClient(clientProfile);

El objeto clientProfile se utiliza para almacenar la información de inicialización del SDK.

: el ID de la región donde activó IoT Platform.

Consulte su región en la esquina superior izquierda de la consola de IoT Platform.

Todos los ID de región disponibles se enumeran en Supported regions.

Inicio de una solicitud

El SDK encapsula dos clases para cada operación de la API. Los nombres de las clases siguen los formatos ${API operation name}+"Request" y ${API operation name}+"Response".

${API operation name}+"Request": esta clase se utiliza para invocar una operación de la API. Puede usar la instancia de solicitud de esta clase e invocar el método request.${request parameter name} para configurar los parámetros de la solicitud.
${API operation name}+"Response" Puede invocar el método GetAcsResponse(request) de la instancia del cliente creada a partir de DefaultAcsClient para obtener una respuesta. Asimismo, puede invocar el método response response.${response parameter name} de la instancia de respuesta de la clase ${API operation name}+"Response" para obtener los valores de los parámetros de respuesta.

Por ejemplo, puede invocar el método response.Success() para obtener el valor del parámetro Success. Este parámetro es un parámetro de respuesta común que indica si la invocación fue exitosa. Los parámetros de respuesta comunes también incluyen RequestId, ErrorMessage y Code.

Para consultar la lista de API en la nube de IoT Platform, consulte API list. Para ver las descripciones de los parámetros de solicitud en request y los parámetros de respuesta en response, consulte la referencia de la API correspondiente.

Este tema utiliza la operación Pub como ejemplo para mostrar cómo publicar un mensaje en un tema. Para obtener información sobre los parámetros de la solicitud, consulte Pub.

Importante

En el siguiente código, ${iotInstanceId} representa el ID de la instancia. Puede encontrar el ID de la instancia actual en la página Instance Overview de la consola de IoT Platform.

Si existe un ID, debe pasar este ID. De lo contrario, la llamada a la API fallará.
Si la página Instance Details o el ID no existen, no es necesario pasar un ID. Puede eliminar el código de solicitud relacionado con IotInstanceId o pasar un valor vacío "". De lo contrario, la llamada a la API fallará.

Para obtener más información sobre las instancias, consulte Instance overview. Para obtener información sobre cómo adquirir una instancia, consulte Purchase an Enterprise instance. Para preguntas frecuentes, consulte FAQ about IoT Platform instances.

PubRequest request = new PubRequest();
request.IotInstanceId = "<iotInstanceId>"; 
request.ProductKey = "<productKey>";
request.TopicFullName = "/<productKey>/<deviceName>/get";
byte[] payload = Encoding.Default.GetBytes("Hello World.");
String payloadStr = Convert.ToBase64String(payload);
request.MessageContent = payloadStr;
request.Qos = 0;
try
{
   PubResponse response = client.GetAcsResponse(request);
   Console.WriteLine("publish message result: " + response.Success);
   Console.WriteLine(response.ErrorMessage);
}
catch (ServerException e)
{
   Console.WriteLine(e.ErrorCode);
   Console.WriteLine(e.ErrorMessage);
}
catch (ClientException e)
{
   Console.WriteLine(e.ErrorCode);
   Console.WriteLine(e.ErrorMessage);
}

Apéndice: Código de ejemplo

Puede visitar el Centro de ejemplos del SDK en la nube de IoT Platform para consultar o descargar código de ejemplo para llamadas a la API. El código de ejemplo incluye muestras para los SDK de Java, Python, PHP, .NET y Go.

El Portal para desarrolladores de OpenAPI de Alibaba Cloud proporciona online API debugging tool. En la página API debugging, puede buscar y probar llamadas a la API. El portal genera automáticamente código de ejemplo del SDK en diferentes lenguajes según los parámetros que introduzca. Consulte el código generado en la pestaña SDK Example y la respuesta en la pestaña Call Result.