Trabalhando com Custom Data Provider

O Custom Data Provider é um elemento que permite criar estruturas de dados simples diretamente no editor de gráficos, eliminando a necessidade de utilizar fontes de dados externas, como arquivos JSON ou Google Sheets, para integrar dados em seus pacotes gráficos.

Este elemento é compatível com outros elementos gráficos que possuem propriedades vinculáveis, facilitando o vínculo de variáveis personalizadas aos seus elementos gráficos.

Adicionar um Custom Data Provider

Dentro dos Data Providers, localize o elemento Custom Data e clique duas vezes nele para adicioná-lo com um escopo de Global Data Provider.
Clique em "New Property"

Adicionar Propriedades

Para começar a utilizar esse elemento, você precisará definir propriedades que ajudarão a construir sua estrutura de dados.

As propriedades disponíveis são:

Text: Através deste campo, você pode editar, criar ou excluir texto dentro do seu gráfico, seja para um título ou para detalhes específicos, como o nome do treinador principal dos times da casa e visitante.
Text List: Permite criar, editar ou excluir uma lista de itens de texto. Por exemplo, você pode criar uma lista com os nomes do time da casa e outra com os do time visitante.
Image: Permite adicionar imagens, como logotipos, bugs de TV e mais. As imagens devem ser carregadas previamente na Asset Library. A principal vantagem dessa propriedade é que ela elimina a necessidade de buscar manualmente as URLs das imagens para vinculá-las.
Images List: Permite ter uma lista de imagens. Por exemplo, você pode mostrar diferentes imagens vinculadas a uma lista dinâmica e ter a capacidade de trocar essas imagens diretamente.
Vídeo: Permite adicionar ou alterar vídeos nos formatos .webm ou .mp4. Você pode trocar ou carregar novos vídeos na Asset Library e exibi-los no seu gráfico. Para saber mais sobre os requisitos para enviar um vídeo, clique aqui.
Color: Permite incluir as cores dos times na sua estrutura de dados para cada time participante.
Font: Permite atribuir uma fonte aos textos vinculados a esse valor. Essa função não pode ser utilizada no Controle Remoto, apenas no Editor Gráfico.

Ao criar propriedades, você precisará fornecer:

Um nome
Uma descrição (opcional)

As propriedades aparecerão listadas no inspector sob a aba Properties. A partir daí, você poderá editar o nome ou a descrição, além de excluir uma propriedade adicionada.

Você pode criar quantas propriedades precisar e reorganizá-las.

Editar Valores

Na aba Values, você tem a capacidade de criar, editar ou excluir os valores que você criou, permitindo gerenciá-los e ajustá-los facilmente conforme necessário.

Mostrar no Controle Remoto

Para exibir dentro do Controle Remoto os "Values" do seu Custom Data Provider configurado no Editor, é necessário ativar a opção Show on Remote Control na aba Values.

Vincular Dados

Uma vez que as Propriedades e seus respectivos Valores estejam adicionados, esses serão os dados disponíveis para vincular aos elementos na Árvore, como Listas Dinâmicas, Elementos de Texto, Imagens e outros.

Controle da API para Custom Data Providers

Alguns "Values" contidos no Custom Data podem ser controlados através da API. Para isso, é necessário habilitar a opção "Integration ID".

Para saber mais sobre como habilitar o "Integration ID", clique aqui.

Os "Values" que podem ser controlados através da API são:

Custom text.
Custom image.
Custom color.

Para mais informações, você pode consultar aqui.

Casos de Uso

Editor Gráfico/Remoto

Quando você já tem um gráfico criado e os "Valores" adicionados ao seu Custom Data Provider, você pode modificar diretamente os elementos vinculados a esses valores. Esses ajustes podem ser feitos diretamente no controle remoto, sem a necessidade de voltar ao editor para fazer as modificações.

Por exemplo, você pode alterar:

Cores: Atualizar as cores dos times ou temas.
Logotipos: Substituir ou atualizar os logotipos conforme necessário.
Patrocinadores: Adicionar ou substituir imagens ou detalhes dos patrocinadores.

Viz Flowics Plugin

Uma vantagem de usar os Custom Data Providers é que dentro do Viz Flowics Plugin, você pode editar diretamente o template desejado.

No caso das imagens, você pode criar uma lista de imagens sem precisar usar uma Google Sheet, o que torna mais fácil selecionar as imagens diretamente da Asset Library.

Para fazer isso, siga os seguintes passos:

Dentro do template no Viz Flowics Plugin, clique em "Select File".
Na Asset Library, selecione a(s) imagem(s) que deseja usar no Plugin e clique em "Select".
Dentro do Plugin, as imagens selecionadas serão exibidas, e você poderá organizá-las na ordem que precisar