Impor Frame — format file

Impor Frame adalah alat pemulihan untuk kasus dukungan — misalnya, mengembalikan koleksi frame setelah perangkat hilang saat tidak ada cadangan iCloud. Fitur ini disembunyikan secara default: menunya muncul di Pengaturan → Cadangan hanya setelah tim dukungan Frame mengaktifkannya untuk akunmu. Kalau kamu merasa membutuhkannya, hubungi kami dulu di [email protected].

Struktur folder

Alat impor meminta kamu memilih satu folder berisi satu file manifest dan foto-foto yang dirujuknya:

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

Foto juga boleh berada di satu subfolder — alat impor menelusuri nama file polos sampai satu tingkat ke dalam.

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

Kolom

Kolom	Wajib	Catatan
client_id	ya	String UUID. Duplikat frame yang sudah ada di perangkat dilewati, tidak pernah ditimpa.
name	ya	Nama tampilan frame.
image	disarankan	Path relatif ke foto produk utama (JPEG/PNG). File yang hilang ditoleransi — frame tetap diimpor tanpa foto.
sticker_image, additional_image_1, additional_image_2	tidak	Foto tambahan, aturan path sama seperti image.
brand, model, shape, size, material, color_variant	tidak	String bebas.
lens_width, bridge_width, temple_length	tidak	Milimeter, berupa angka.
is_favorite	tidak	Boolean, default false.
price_amount, price_currency, original_price_amount, product_url	tidak	Metadata harga.
created_at	tidak	Stempel waktu ISO 8601; default-nya waktu impor.

Cara kerja impor

• Bersifat menambah saja: frame yang sudah ada tidak pernah diubah atau dihapus.
• Deduplikasi memakai client_id — menjalankan ulang impor yang sama tetap aman.
• Frame hasil impor tersinkron ke akun dan cadangan iCloud kamu seperti frame yang ditambahkan biasa.