Guia de início rápido: crie seu primeiro aplicativo Kinect do Azure

Artigo
06/26/2019

Está a começar a utilizar o Azure Kinect DK? Este guia de início rápido irá colocá-lo em funcionamento com o dispositivo!

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

São abrangidas as seguintes funções:

Pré-requisitos

Configure o dispositivo Azure Kinect DK.
Baixe e instale o SDK do Sensor Kinect do Azure.

Cabeçalhos

Há apenas um cabeçalho que você vai precisar, e isso é k4a.h. Certifique-se de que seu compilador de escolha esteja configurado com a lib do SDK e inclua pastas. Você também precisará dos k4a.lib e k4a.dll arquivos vinculados. Você pode querer se referir a adicionar a biblioteca do Azure Kinect ao seu projeto.

#include <k4a/k4a.h>

Localizando um dispositivo DK do Azure Kinect

Vários dispositivos Azure Kinect DK podem ser conectados ao seu computador. Primeiro, começaremos descobrindo quantos ou se algum está conectado usando a k4a_device_get_installed_count() função. Esta função deve funcionar imediatamente, sem qualquer configuração adicional.

uint32_t count = k4a_device_get_installed_count();

Depois de determinar que há um dispositivo conectado ao computador, você pode abri-lo usando k4a_device_open()o . Você pode fornecer o índice do dispositivo que deseja abrir, ou você pode apenas usar K4A_DEVICE_DEFAULT para o primeiro.

// Open the first plugged in Kinect device
k4a_device_t device = NULL;
k4a_device_open(K4A_DEVICE_DEFAULT, &device);

Como acontece com a maioria das coisas na biblioteca do Azure Kinect, quando você abre algo, também deve fechá-lo quando terminar de usá-lo! Quando estiver desligando, lembre-se de fazer uma chamada para k4a_device_close().

k4a_device_close(device);

Assim que o dispositivo estiver aberto, podemos fazer um teste para garantir que está a funcionar. Então vamos ler o número de série do dispositivo!

// Get the size of the serial number
size_t serial_size = 0;
k4a_device_get_serialnum(device, NULL, &serial_size);

// Allocate memory for the serial, then acquire it
char *serial = (char*)(malloc(serial_size));
k4a_device_get_serialnum(device, serial, &serial_size);
printf("Opened device: %s\n", serial);
free(serial);

Iniciando as câmeras

Depois de abrir o dispositivo, você precisará configurar a câmera com um k4a_device_configuration_t objeto. A configuração da câmera tem uma série de opções diferentes. Escolha as configurações que melhor se ajustam ao seu próprio cenário.

// Configure a stream of 4096x3072 BRGA color data at 15 frames per second
k4a_device_configuration_t config = K4A_DEVICE_CONFIG_INIT_DISABLE_ALL;
config.camera_fps       = K4A_FRAMES_PER_SECOND_15;
config.color_format     = K4A_IMAGE_FORMAT_COLOR_BGRA32;
config.color_resolution = K4A_COLOR_RESOLUTION_3072P;

// Start the camera with the given configuration
k4a_device_start_cameras(device, &config);

// ...Camera capture and application specific code would go here...

// Shut down the camera when finished with application logic
k4a_device_stop_cameras(device);

Processamento de erros

Por uma questão de brevidade e clareza, não mostramos o tratamento de erros em alguns exemplos embutidos. No entanto, o tratamento de erros é sempre importante! Muitas funções retornarão um tipo k4a_result_tgeral de sucesso/falha ou uma variante mais específica com informações detalhadas, como k4a_wait_result_t. Verifique os documentos ou IntelliSense para cada função para ver quais mensagens de erro você deve esperar ver a partir dele!

Você pode usar as K4A_SUCCEEDED macros e K4A_FAILED para verificar o resultado de uma função. Portanto, em vez de apenas abrir um dispositivo DK do Azure Kinect, podemos proteger a chamada de função da seguinte forma:

// Open the first plugged in Kinect device
k4a_device_t device = NULL;
if ( K4A_FAILED( k4a_device_open(K4A_DEVICE_DEFAULT, &device) ) )
{
    printf("Failed to open k4a device!\n");
    return;
}

Fonte completa

#pragma comment(lib, "k4a.lib")
#include <k4a/k4a.h>

#include <stdio.h>
#include <stdlib.h>

int main()
{
    uint32_t count = k4a_device_get_installed_count();
    if (count == 0)
    {
        printf("No k4a devices attached!\n");
        return 1;
    }

    // Open the first plugged in Kinect device
    k4a_device_t device = NULL;
    if (K4A_FAILED(k4a_device_open(K4A_DEVICE_DEFAULT, &device)))
    {
        printf("Failed to open k4a device!\n");
        return 1;
    }

    // Get the size of the serial number
    size_t serial_size = 0;
    k4a_device_get_serialnum(device, NULL, &serial_size);

    // Allocate memory for the serial, then acquire it
    char *serial = (char*)(malloc(serial_size));
    k4a_device_get_serialnum(device, serial, &serial_size);
    printf("Opened device: %s\n", serial);
    free(serial);

    // Configure a stream of 4096x3072 BRGA color data at 15 frames per second
    k4a_device_configuration_t config = K4A_DEVICE_CONFIG_INIT_DISABLE_ALL;
    config.camera_fps       = K4A_FRAMES_PER_SECOND_15;
    config.color_format     = K4A_IMAGE_FORMAT_COLOR_BGRA32;
    config.color_resolution = K4A_COLOR_RESOLUTION_3072P;

    // Start the camera with the given configuration
    if (K4A_FAILED(k4a_device_start_cameras(device, &config)))
    {
        printf("Failed to start cameras!\n");
        k4a_device_close(device);
        return 1;
    }

    // Camera capture and application specific code would go here

    // Shut down the camera when finished with application logic
    k4a_device_stop_cameras(device);
    k4a_device_close(device);

    return 0;
}

Próximos passos

Saiba como localizar e abrir um dispositivo Azure Kinect DK usando o SDK do Sensor

Localizar e abrir um dispositivo

Partilhar via