Instruções para adicionar os parâmetros de tela de novos dispositivos iOS ao SDK do Cardboard e ao plug-in XR

A cada ano, novos dispositivos iOS são lançados. Para que o SDK do Cardboard ou o plug-in do Cardboard XR funcionem com esses novos dispositivos, atualize o arquivo resolutions.csv do projeto que você está usando.

Fonte de informação

  • As strings de modelo podem ser encontradas no The Apple Wiki (link em inglês).
  • Os valores de DPI (também chamados de PPI) podem ser encontrados nas especificações técnicas da Apple (por exemplo, consulte as especificações do iPhone 16).

O que precisa ser atualizado

Dependendo se você está usando o SDK do Cardboard ou o plug-in do Cardboard XR, atualize o arquivo resolutions.csv correspondente:

Ambos carregam os parâmetros da tela do dispositivo de forma dinâmica no ambiente de execução de resolutions.csv dentro de sdk.bundle.

  • Ao contribuir com novos parâmetros de dispositivo para o Google Cardboard, envie solicitações de envio para os repositórios do SDK do Cardboard e do plug-in do Cardboard XR. Eles são mantidos sincronizados usando LINT.IfChange / LINT.ThenChange.
  • Para projetos locais do Unity que usam pacotes UPM imutáveis em Library/PackageCache/, os desenvolvedores podem editar resolutions.csv diretamente no projeto Xcode exportado em Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Formato de resolutions.csv

Adicione uma nova linha para cada dispositivo usando o seguinte formato separado por vírgulas:

identifier,device_name,dpis
  • identifier: a string do modelo de hardware obtida no The Apple Wiki, com qualquer vírgula substituída por um ponto (por exemplo, iPhone17,3 se torna iPhone17.3).
  • device_name: o nome de mercado do dispositivo (por exemplo, iPhone 16). Ele não pode conter vírgulas, porque o analisador de ambiente de execução (stringSplit em screen_params.mm) divide as vírgulas em uma matriz fixa de três elementos sem suporte a aspas. Uma vírgula incorporada deslocaria o token de DPI e faria com que ele fosse avaliado como 0.0.
  • dpis: a densidade de pixels da tela em DPI/PPI seguida por f (por exemplo, 460.0f).

Entradas de exemplo

iPhone17.3,iPhone 16,460.0f
iPhone17.4,iPhone 16 Plus,460.0f
iPhone17.1,iPhone 16 Pro,460.0f
iPhone17.2,iPhone 16 Pro Max,460.0f