> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/data-oriented-programming.md).

# Programação Orientada a Dados

A Programação Orientada a Dados é uma abordagem poderosa de programação que aproveita ao máximo o desempenho.

A Programação Orientada a Dados é uma abordagem poderosa à programação que proporciona grandes melhorias de desempenho. O seu foco é tratar os *dados* como elemento central, organizando tudo o resto à sua volta para aceder a esses dados ou modificá-los. Esta abordagem também é muito adequada a experiências multijogador, pois facilita e agiliza o acesso aos dados que têm de ser sincronizados entre jogadores.

A Programação Orientada a Dados incentiva-o a pensar em tudo na sua Scene como dados que têm de ser copiados e alterados pelos vários Systems. A principal vantagem desta abordagem está em otimizar a velocidade de leitura dos dados na memória, que é muitas vezes o principal estrangulamento na execução de aplicações e jogos modernos.

Devido a esta notável melhoria de desempenho, grande parte da indústria dos videojogos tem vindo a adotar esta abordagem nos últimos anos.

O SDK da Decentraland executa as Scenes em JavaScript, e uma das desvantagens desta linguagem é não permitir controlar a alocação de memória. No entanto, o Engine que executa a Decentraland usa C#, que beneficia bastante da aplicação de princípios orientados a dados. O SDK e o Engine estão constantemente a enviar mensagens entre si. Para tornar esta comunicação o mais eficiente possível, faz sentido manter as estruturas de dados em ambos os lados tão semelhantes quanto possível, evitando reorganizá-las constantemente.

## Como funciona

A Programação Orientada a Dados é diferente da Programação Orientada a Objetos, uma abordagem que muitos programadores conhecem atualmente. Na Programação Orientada a Objetos, o código é estruturado com base em abstrações que tentam replicar elementos do mundo real: objetos. Cada um destes objetos pode conter dados e funcionalidades. As aplicações que usam esta abordagem são muitas vezes fáceis de planear conceptualmente, mas também são menos eficientes na execução.

Na Programação Orientada a Dados, os dados não são estruturados em torno de objetos; são estruturados para otimizar a facilidade de acesso. Os elementos do mundo real representados pelos dados não têm qualquer papel nos diferentes fluxos que os alteram.

O modelo Entity Component System (ECS), no qual o SDK da Decentraland se baseia, é muito compatível com a abordagem de Programação Orientada a Dados. Cada Component faz parte de uma coleção estruturada de dados. Os Components pertencem a uma Entity por referência, mas os dados não são estruturados em torno da Entity: são estruturados como uma coleção de Components semelhantes. Por exemplo, todos os Components `Transform` numa Scene são iguais. Um destes transforms pode pertencer ao modelo do edifício principal, outro a um copo que é filho de uma mesa. Os Systems na Scene processam então a lista de Components, um a um, sem fazer distinções. Todos os Components `Transform` têm os mesmos campos e são submetidos às mesmas verificações. `Transform` têm os mesmos campos e são submetidos às mesmas verificações.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-eed4c8cf199995170d4215c711819cca890e6fc7%2Fcomponent-stacks.webp?alt=media)

Imagine uma Scene com uma dúzia de portas que podem estar abertas ou fechadas. Pode representar o estado de todas estas portas com um Component simples, chamado «isOpen», que contém um valor booleano. Se «isOpen» for true, a porta deve estar aberta; se for false, deve estar fechada. Se um jogador clicar numa porta, o estado deve alternar, e os outros jogadores também devem ver essa alteração. Enquanto a Scene processa uma alteração do estado de uma porta e a sincroniza com os outros jogadores, não precisa de saber o que «isOpen» representa. O conjunto completo de Components é apenas uma coleção de valores booleanos que têm de ser sincronizados com os outros jogadores. Um System separado na Scene pode depois tratar de alinhar periodicamente o estado de cada «isOpen» com a rotação da porta correspondente.

A Programação Orientada a Dados não é necessariamente mais difícil, mas é uma abordagem diferente que é preciso aprender e adotar. Os programadores que não estejam familiarizados com esta abordagem podem precisar de algum tempo para se habituarem; recomendamos que explore e experimente alguns exemplos para a compreender melhor.

## Porque funciona

Para compreender porque é que a programação orientada a dados faz tanta diferença, temos de analisar o hardware.

Quando o processador precisa de obter dados da memória, carrega para a cache um bloco inteiro de dados, incluindo dados que, por acaso, estão escritos na memória ao lado do valor pretendido. Quanto mais o código conseguir usar dados que já estão na cache, mais depressa será executado.

Imagine que a memória da máquina é um armazém real, onde os dados estão guardados em muitas caixas empilhadas. Sempre que precisamos de um determinado dado, temos de chamar um empilhador para ir buscar a caixa onde ele está e trazê-la até ao balcão para ser inspecionada. Nesse balcão só cabem algumas caixas de cada vez, por isso não podemos ter muitos dados à mão.

O empilhador demora muito tempo a atravessar o armazém e a trazer-nos uma caixa. Se os dados que pretende obter dessas caixas estiverem dispersos, terá de pedir ao empilhador que faça muitas viagens. Na maior parte do tempo, ficará à espera junto ao balcão, sem fazer nada, até chegar a próxima caixa que pediu.

Pode evitar grande parte desse desperdício de tempo se empilhar as caixas de forma inteligente e organizar os dados de modo a agrupar, na maioria dos casos, os elementos de que provavelmente precisará ao mesmo tempo. Se agrupar os dados com cuidado, muitas vezes descobrirá que o próximo elemento de que precisa já está numa das caixas junto ao balcão. Poderá aceder-lhe de imediato, sem incomodar o operador do empilhador.

Por exemplo, se tiver uma Scene que precisa de obter o estado de uma porta para verificar se está aberta ou fechada, o hardware não obtém apenas o valor booleano específico que descreve o estado dessa porta: obtém também muitos outros dados que podem ou não ser relevantes.

Suponha que a sua Scene tem um System que precisa de atualizar o estado aberto/fechado de uma dúzia de portas, uma vez por frame. Se o seu código estiver organizado segundo uma abordagem de Programação Orientada a Objetos, não há como saber como serão agrupadas as diferentes informações relevantes. Talvez uma «caixa» do nosso armazém contenha o estado «isOpen» da porta A, bem como a textura dessa porta e o áudio que reproduz ao abrir. Poderá ter de fazer uma viagem para obter uma nova «caixa» de dados para cada uma das doze portas. E, claro, todo este processo tem de se repetir em cada frame. A 60 frames por segundo, são 720 (60 x 12) viagens metafóricas à parte de trás do armazém por segundo, mesmo que o estado de nenhuma porta tenha mudado.

Por outro lado, se o seu código seguir uma abordagem orientada a dados, é muito provável que os 12 valores booleanos estejam todos na mesma caixa. Isto acontece porque estes valores booleanos fazem parte de um único array que foi escrito na memória de uma só vez. Nunca organiza explicitamente a forma como estes dados ficam dispostos na memória, por isso, no pior cenário, o array pode acabar dividido entre duas caixas. Mas mesmo nesse pior cenário, duas viagens são muito melhor do que doze.

Verificar o estado de todas as portas em cada frame parece dar muito trabalho, mas é, na verdade, extremamente rápido se todos os dados já estiverem na cache da memória. Se os seus dados estiverem bem organizados, a sua Scene pode executar processos deste tipo em muitas Entities e continuar a funcionar muito depressa.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/data-oriented-programming.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
