Importa montature — formato file

Importa montature è uno strumento di recupero per i casi di supporto — ad esempio, per ripristinare una libreria di montature dopo la perdita del dispositivo, quando non esiste un backup iCloud. È nascosto per impostazione predefinita: la voce compare in Impostazioni → Backup solo dopo che il supporto Frame lo attiva per il tuo account. Se pensi di averne bisogno, scrivici prima a [email protected].

Struttura della cartella

L'importatore ti chiede di scegliere una cartella che contenga un file manifest e le foto a cui fa riferimento:

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

Le foto possono trovarsi anche in una sottocartella annidata — l'importatore risolve i nomi file semplici fino a un livello di profondità.

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"
    }
  ]
}

Campi

Campo	Obbligatorio	Note
client_id	sì	Stringa UUID. I duplicati di montature già presenti sul dispositivo vengono saltati, mai sovrascritti.
name	sì	Nome visualizzato della montatura.
image	consigliato	Percorso relativo alla foto principale del prodotto (JPEG/PNG). Un file mancante è tollerato: la montatura viene importata senza foto.
sticker_image, additional_image_1, additional_image_2	no	Foto aggiuntive, stesse regole di percorso di image.
brand, model, shape, size, material, color_variant	no	Stringhe in formato libero.
lens_width, bridge_width, temple_length	no	Millimetri, numeri.
is_favorite	no	Booleano, valore predefinito false.
price_amount, price_currency, original_price_amount, product_url	no	Metadati di prezzo.
created_at	no	Timestamp ISO 8601; se assente, viene usata l'ora dell'importazione.

Come si comporta l'importazione

• Solo in aggiunta: le montature esistenti non vengono mai modificate né eliminate.
• La deduplica avviene tramite client_id — rieseguire la stessa importazione è sicuro.
• Le montature importate si sincronizzano con il tuo account e con il backup iCloud come quelle aggiunte normalmente.