Usar o IoT Platform SDK para .NET - IoT Platform: Central de Documentação do Alibaba Cloud

O IoT Platform oferece um SDK para .NET aos desenvolvedores. Este tópico descreve como instale e configure o IoT Platform SDK para .NET e como usar o SDK para chamar as operações de API do IoT Platform.

Instale o IoT Platform SDK para .NET

Instale os ambientes de desenvolvimento .NET.
O IoT Platform SDK para .NET é compatível com os seguintes ambientes de desenvolvimento:
- .NET Framework 4.5 e posterior
- .NET Standard 2.0 e posterior
- C# 4,0 e posterior
- Visual Studio 2010 e posterior
Instale o IoT Platform SDK para .NET usando o gerenciador de pacotes NuGet.

Este exemplo usa o Visual Studio.
1. No painel Solution Explorer do Visual Studio, clique em no projeto e selecione Manage NuGet Packages.
2. No painel NuGet Package Manager, clique em Browse.
3. Na guia Browse, insira aliyun-net-sdk na caixa de pesquisa e selecione o pacote aliyun-net-sdk-iot fornecido pela Alibaba Cloud.
4. Clique em Install.

Inicializar o IoT Platform SDK para C++

O código a seguir mostra um exemplo de inicialização do SDK para chamar uma API na região China (Shanghai).

Crie o objeto clientProfile para armazenar as informações de inicialização do SDK. Em seguida, crie a instância do cliente a partir de DefaultAcsClient. Use o método DefaultAcsClient(clientProfile) para carregar as informações de inicialização do 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);

O objeto clientProfile armazena as informações de inicialização do SDK.

: ID da região onde você ativou o IoT Platform.

Verifique sua região no canto superior esquerdo do console do IoT Platform.

Todos os IDs de região disponíveis estão listados em Regiões suportadas.

Iniciar uma solicitação

O SDK encapsula duas classes para cada operação de API. Os nomes das classes seguem os formatos ${API operation name}+"Request" e ${API operation name}+"Response".

${API operation name}+"Request": Esta classe serve para chamar uma operação de API. Use a instância de solicitação desta classe e chame o método request.${request parameter name} para definir os parâmetros da solicitação.
${API operation name}+"Response" Chame o método GetAcsResponse(request) da instância do cliente criada a partir de DefaultAcsClient para obter uma resposta. Para recuperar os valores dos parâmetros de resposta, use o método response response.${response parameter name} da instância de resposta da classe ${API operation name}+"Response".

Por exemplo, chame o método response.Success() para obter o valor do parâmetro Success. Esse parâmetro é comum nas respostas e indica se a chamada foi bem-sucedida. Outros parâmetros de resposta comuns incluem RequestId, ErrorMessage e Code.

Para consultar a lista de APIs de nuvem do IoT Platform, visualize Lista de APIs. Para obter descrições dos parâmetros de solicitação em request e dos parâmetros de resposta em response, consulte a referência da API correspondente.

Este tópico usa a operação Pub como exemplo para demonstrar a publicação de uma mensagem em um tópico. Para mais detalhes sobre os parâmetros de solicitação, consulte Pub.

Importante

No código abaixo, ${iotInstanceId} representa o ID da instância. Você encontra o ID da instância atual na página Instance Overview no console do IoT Platform.

Se existir um ID, informe-o obrigatoriamente. Caso contrário, a chamada de API falhará.
Se a página Instance Details ou o ID não existirem, não será necessário passar um ID. Exclua o código de solicitação relacionado a IotInstanceId ou passe um valor vazio "". Do contrário, a chamada de API falhará.

Para mais informações sobre instâncias, consulte Visão geral de instâncias. Para saber como adquirir uma instância, visualize Adquirir uma instância Enterprise. Para perguntas frequentes, acesse Perguntas frequentes sobre instâncias do IoT Platform.

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 exemplo

Acesse o Centro de Exemplos do SDK de Nuvem do IoT Platform para visualizar ou baixe códigos de exemplo para chamadas de API. Os exemplos abrangem os SDKs para Java, Python, PHP, .NET e Go.

O Portal do Desenvolvedor OpenAPI da Alibaba Cloud disponibiliza uma ferramenta online de depuração de API. Na página API debugging, pesquise e teste chamadas de API. O portal gera automaticamente códigos de exemplo do SDK em diferentes linguagens com base nos parâmetros inseridos. Visualize o código gerado na guia SDK Example e a resposta na guia Call Result.