Importar Armações — formato de arquivo

Importar Armações é uma ferramenta de recuperação para casos de suporte — por exemplo, restaurar uma biblioteca de armações após a perda do aparelho quando não existe backup no iCloud. Ela fica oculta por padrão: o item aparece em Ajustes → Backup somente depois que o suporte do Frame a habilita para sua conta. Se você acha que precisa dela, fale antes com a gente pelo [email protected].

Estrutura da pasta

O importador pede que você escolha uma pasta contendo um arquivo de manifesto e as fotos referenciadas por ele:

My Frames/
├── frames.json
├── rayban-aviator.jpg
├── rayban-aviator-sticker.jpg
└── persol-649.jpg

As fotos também podem ficar em uma subpasta aninhada — o importador resolve nomes de arquivo simples até um nível de profundidade.

frames.json

{
  "version": 1,
  "frames": [
    {
      "client_id": "5D2A7C1E-4B9F-4E2A-8C3D-1F6E9A0B2C4D",
      "name": "Ray-Ban Aviator",
      "image": "rayban-aviator.jpg",
      "sticker_image": "rayban-aviator-sticker.jpg",
      "brand": "Ray-Ban",
      "model": "RB3025",
      "shape": "aviator",
      "is_favorite": true,
      "price_amount": 161.0,
      "price_currency": "USD",
      "product_url": "https://example.com/rb3025",
      "created_at": "2026-05-01T10:00:00Z"
    },
    {
      "client_id": "0A1B2C3D-4E5F-6789-ABCD-EF0123456789",
      "name": "Persol 649",
      "image": "persol-649.jpg"
    }
  ]
}

Campos

Campo	Obrigatório	Notas
client_id	sim	String UUID. Duplicatas de armações que já estão no aparelho são ignoradas, nunca sobrescritas.
name	sim	Nome de exibição da armação.
image	recomendado	Caminho relativo da foto principal do produto (JPEG/PNG). Um arquivo ausente é tolerado — a armação é importada sem foto.
sticker_image, additional_image_1, additional_image_2	não	Fotos extras, com as mesmas regras de caminho de image.
brand, model, shape, size, material, color_variant	não	Strings de texto livre.
lens_width, bridge_width, temple_length	não	Milímetros, números.
is_favorite	não	Booleano, padrão false.
price_amount, price_currency, original_price_amount, product_url	não	Metadados de preço.
created_at	não	Timestamp ISO 8601; por padrão, o horário da importação.

Como a importação se comporta

• Estritamente aditiva: as armações existentes nunca são modificadas nem excluídas.
• A deduplicação é feita por client_id — repetir a mesma importação é seguro.
• As armações importadas sincronizam com sua conta e com o backup no iCloud como as armações adicionadas normalmente.