arfit_sdk 1.0.1

ARFit SDK - Augmented Reality shopping experience for mobile and web

ARFit SDK 🛒📱

Flutter uygulamanıza 3 satırda Augmented Reality (AR) alışveriş deneyimi ekleyin!

---

✨ Özellikler

• ✅ Kolay Entegrasyon - Mevcut ürün ID'lerinizi kullanın
• ✅ Otomatik Analitik - Kullanıcı davranışları otomatik takip edilir
• ✅ Özelleştirilebilir - Buton tasarımını dilediğiniz gibi değiştirin
• ✅ Web & Mobil Desteği - Tüm platformlarda çalışır
• ✅ Sıfır Konfigürasyon - 3D modeller ARFit tarafından sağlanır

---

📦 Kurulum

pubspec.yaml dosyanıza ekleyin:

dependencies:
  arfit_sdk: ^1.0.0

Terminalde çalıştırın:

flutter pub get

---

🚀 Kullanım (3 Adım)

1️⃣ SDK'yı Başlatın

Ana main.dart dosyanızda bir kez başlatın:

import 'package:flutter/material.dart';
import 'package:arfit_sdk/arfit_sdk.dart';

void main() {
  ARFitAnalytics().initialize(
    apiUrl: 'https://arfit-api.arfitcompany.workers.dev',
  );
  
  runApp(MyApp());
}

2️⃣ Ürün ID'lerinizi ARFit'e Gönderin

ARFit ekibine mevcut ürün ID'lerinizi ve ürün bilgilerinizi gönderin:

📧 Email: [e-mail]

Konu: Yeni Ürün AR Entegrasyonu

Ürün Bilgileri:
- Ürün ID: decathlon-8308622
- Ürün Adı: Eliptik Bisiklet Pro
- Kategori: Cardio
- Fiyat: 8999 TL
- Görseller: [ürün-görselleri.zip]

ARFit ekibi:

1. Ürünü 3D olarak tarar
2. Sisteme yükler
3. Sizin ID'nizi kullanarak kaydeder
4. Size "Hazır!" mesajı gönderir

3️⃣ Kendi Ürün ID'nizi Kullanın

Ürün sayfanıza AR butonu ekleyin - kendi ID'nizi kullanın:

ARFitButton(
  productId: 'decathlon-8308622',  // ← SİZİN ürün ID'niz
  productName: 'Eliptik Bisiklet Pro',
  modelUrl: '',  // ← Boş bırakın, otomatik çekilir
)

Hepsi bu kadar! 🎉

---

💡 Nasıl Çalışır?

1. Kullanıcı AR butonuna tıklar
   ↓
2. SDK sizin ürün ID'nizi gönderir: "decathlon-8308622"
   ↓
3. ARFit sunucusu bu ID için 3D modeli bulur
   ↓
4. AR görüntüleyici açılır ve modeli gösterir

Siz sadece mevcut ürün ID'lerinizi kullanırsınız!

---

🎨 Özelleştirme

Buton Stilini Değiştirin

ARFitButton(
  productId: 'URUN-ID-123',  // Kendi ID'niz
  productName: 'Koşu Bandı X200',
  modelUrl: '',
  buttonText: 'AR ile İncele',
  style: ElevatedButton.styleFrom(
    backgroundColor: Colors.purple,
    padding: EdgeInsets.symmetric(horizontal: 32, vertical: 16),
  ),
)

Floating AR Baloncuğu

Stack(
  children: [
    // Ürün sayfanız...
    
    ARFitFloatingButton(
      productId: 'URUN-ID-123',
      productName: 'Koşu Bandı X200',
      modelUrl: '',
      showDelay: Duration(seconds: 2),
    ),
  ],
)

---

📊 Analitik Dashboard

Tüm kullanım istatistiklerinizi görüntüleyin:

👉 Dashboard'a Git

• Hangi ürünler daha çok AR ile görüntüleniyor
• AR kullanımı sepet dönüşümünü ne kadar artırıyor
• Kullanıcı davranış analitiği

---

💼 Örnek Entegrasyon

E-Ticaret Ürün Listesi

class ProductCard extends StatelessWidget {
  final Product product;
  
  @override
  Widget build(BuildContext context) {
    return Card(
      child: Column(
        children: [
          Image.network(product.imageUrl),
          Text(product.name),
          Text('${product.price} ₺'),
          
          // AR butonu - Kendi ürün ID'nizi kullanın
          ARFitButton(
            productId: product.id,  // ← Kendi veritabanınızdaki ID
            productName: product.name,
            modelUrl: '',
          ),
          
          AddToCartButton(product: product),
        ],
      ),
    );
  }
}

Ürün Detay Sayfası

Scaffold(
  body: SingleChildScrollView(
    child: Column(
      children: [
        ProductImageGallery(product: product),
        ProductInfo(product: product),
        
        // AR butonu
        Padding(
          padding: EdgeInsets.all(16),
          child: ARFitButton(
            productId: product.id,  // ← Mevcut ID sisteminiz
            productName: product.name,
            modelUrl: '',
          ),
        ),
        
        ProductDescription(product: product),
        AddToCartButton(product: product),
      ],
    ),
  ),
)

---

🆕 Yeni Ürün Ekleme Süreci

1. Email Atın: [e-mail]
2. Ürün Bilgilerini Gönderin:
   • Ürün ID (sizin sisteminizdeki)
   • Ürün adı
   • Görseller (farklı açılardan)
   • Ölçüler (varsa)
3. Bekleyin: ARFit ekibi 3D modelini oluşturur (2-5 gün)
4. Onay Alın: "Ürün hazır!" mesajı gelir
5. Kullanın: Kodunuza sadece kendi ID'nizi ekleyin

3D tarama ve model oluşturma tamamen ARFit sorumluluğundadır!

---

❓ Sıkça Sorulan Sorular

Mevcut ürün ID sistemimizi değiştirmemiz gerekir mi?

Hayır! Kendi ID sisteminizi kullanmaya devam edin. ARFit, sizin ID'lerinizi kullanarak 3D modelleri eşleştirir.

Her ürün için AR desteği eklemeli miyiz?

Hayır, sadece AR ile gösterilmesini istediğiniz ürünler için ARFitButton ekleyin. Diğer ürünler normal çalışmaya devam eder.

3D model güncellenirse ne olur?

ARFit tarafında güncellenir, sizin kodunuzda hiçbir değişiklik gerekmez. Kullanıcılar otomatik olarak yeni modeli görür.

---

🐛 Sorun Giderme

"SDK not initialized" hatası

// main.dart'ta initialize() çağrısını kontrol edin
ARFitAnalytics().initialize(
  apiUrl: 'https://arfit-api.arfitcompany.workers.dev',
);

"Model bulunamadı" hatası

• Ürün ID'sinin doğru olduğundan emin olun
• ARFit ekibine ürünün sisteme eklendiğini teyit edin
• Email: [e-mail]

---

📱 Platform Desteği

Platform	Durum	Notlar
Android	✅	ARCore gerektirir
iOS	✅	ARKit gerektirir
Web	⚠️	Önizleme modu

---

🤝 Destek & İletişim

• 📧 Email: [e-mail]
• 🌐 Website: https://arfit.dev
• 📊 Dashboard: https://arfit-api.arfitcompany.workers.dev/dashboard

---

📄 Lisans

MIT License

---

🙏 Teşekkürler

ARFit SDK'yı kullandığınız için teşekkürler! ⭐️