Ana Sayfa
EN
Referans

Sorun giderme

Sık karşılaşılan sorunlar ve çözümleri: tanıma, kamera, ses ve senkron.

Bir şey beklediğiniz gibi çalışmadığında, çözüm genellikle birkaç dokunuş uzaktadır. Bu sayfa QCR Scanner kullanırken en çok karşılaşılan sorunları belirti–neden–çözüm sırasıyla ele alır: metin tanıma, kamera ve izinler, QR okuma, sesle giriş, webhook senkronu, reklamlar ve AI kural üreticisi. Her başlık kısa ve uygulanabilir tutulmuştur; daha derin ayrıntı için ilgili kılavuza köprü verilir.

Küçük metin okunmuyor

Belirti: seri numarası, rakam ya da yoğun yazı tanınmıyor veya yanlış okunuyor. Neden: varsayılan Şipşak mod (⚡) sıcak 1080p kamera akışından son kareyi alıp bellekte anında işler; çok hızlıdır ama küçük veya sıkışık metinde zorlanabilir.

  • Sol koldaki şimşek/HD düğmesine dokunup Kalite moduna geçin. Tam çözünürlüklü çekim ve cihazda native kod çözme, küçük rakamlar için en yüksek doğruluğu verir. Tercihiniz cihazda saklanır.
  • Yakınlaştırma çubuğuyla hedefi büyütün; metin çerçevede ne kadar büyük olursa o kadar iyi okunur.
  • Düşük ışıkta feneri (torch) açın.
  • Net değilse ekrana dokunarak odaklayın veya odak kilidini kullanın.
  • Vizördeki ortadaki dikdörtgeni yalnızca hedef metni saracak şekilde boyutlandırın; çevredeki gürültü tanımayı bozabilir.

İpucu: Tek bir karede birden çok değer varsa, gürültülü metinden uygun parçaları otomatik ayıklamak için Akıllı Çıkarım kullanın. Mod ve kamera kontrollerinin tamamı için Tarama sayfasına bakın.

Kamera açılmıyor

Belirti: tarama ekranı siyah kalıyor ya da kamera başlamıyor. Neden: çoğunlukla kamera izni reddedilmiştir veya başka bir uygulama kamerayı kullanıyordur.

  • Telefon ayarlarından QCR Scanner için Kamera (CAMERA) iznini verin. İzin daha önce reddedildiyse uygulama içinden tekrar istenemeyebilir; bu durumda sistem ayarlarından elle açın.
  • Kamerayı kullanan başka uygulamaları kapatın ve QCR Scanner’ı yeniden başlatın.
  • Sorun sürerse cihazı yeniden başlatmak, kilitli kalan kamera oturumunu temizler.

QR kod okunmuyor

Belirti: çerçevede bir QR/barkod var ama tanınmıyor. Hatırlatma: dokunduğunuzda OCR ve QR taraması paralel çalışır ve bir QR bulunursa önceliklidir.

  • Vizördeki dikdörtgeni genişletin; QR kodun tamamı çerçeveye girmelidir.
  • Telefonu koda biraz daha uzak ya da yakın tutarak mesafeyi ayarlayın; çok yakınken kamera odaklanamayabilir.
  • Yansıma ve gölgeyi azaltın; parlak ekranlardaki kodlar için açıyı değiştirin.
  • Kod buruşuk, soluk ya da kısmen kapalıysa düzleştirin veya temizleyin.

Sesle giriş çalışmıyor

Belirti: konuştuğunuzda değer eklenmiyor veya mikrofon tepki vermiyor. Neden: mikrofon izni eksik olabilir ya da cihazınızda gerekli konuşma tanıma dili yüklü değildir.

  • Telefon ayarlarından Mikrofon (RECORD_AUDIO) iznini verin.
  • Sesle giriş cihazınızın konuşma tanıma motorunu kullanır; konuştuğunuz dilin dil paketi telefonda yüklü olmalıdır.
  • Doğru modu seçtiğinizden emin olun: bas-konuş tek söz dinler, sürekli durmadan dinleyip basamak sayısına göre böler, doğrula OCR sonucunu sesli teyit eder.
  • Gürültülü ortamlarda daha net ve yavaş konuşun; arka plan sesi tanımayı düşürür.

Ayrıntılar için Sesle giriş sayfasına bakın.

Webhook senkronu başarısız

Belirti: değerler sunucuya gitmiyor veya senkron hata veriyor. QCR Scanner her gönderimi 3 denemeli üstel geri çekilmeyle (1s/2s/4s) tekrarlar; yine de başarısız olursa aşağıdakileri denetleyin.

  • URL’yi doğrulayın: tam ve doğru adres olmalı. Senkron ekranındaki test bağlantısı, uç noktaya bir {"action":"ping"} gövdesi göndererek erişimi sınar.
  • Sunucunuz kimlik doğrulama istiyorsa isteğe bağlı Authorization başlığını girin.
  • Ağ bağlantınızı kontrol edin. Hat yokken gönderimler çevrimdışı outbox kuyruğuna alınır ve bağlantı gelince otomatik denenir (uygulama öne geldiğinde de tekrar denenir); bu yüzden çoğu kesinti kendiliğinden düzelir.
  • Sunucunun beklediği gövdeyle eşleştiğinden emin olun. Tekil gönderim örneği:
{
  "action": "add",
  "listName": "Depo",
  "item": {
    "value": "ABC123",
    "isQR": false,
    "source": "ocr",
    "createdAt": "2026-06-21T10:00:00Z",
    "isSeparator": false
  },
  "timestamp": "2026-06-21T10:00:00Z"
}

Toplu gönderim (“Send all”) aynı yapıda bir items[] dizisi ve bir count alanı taşır. Uçtan uca kurulum ve hazır bir Cloudflare Worker örneği için Webhook senkronu sayfasına bakın.

Reklamlar ve Pro

QCR Scanner ücretsizdir ve bir AdMob banner reklamı içerir. Reklamsız bir Pro abonelik planlanıyor, ancak henüz mevcut değildir; dolayısıyla şu an reklamı kaldıran bir seçenek bulunmaz. Banner bazen yüklenmek için kısa süre bekleyebilir; ağ bağlantısı zayıfsa boş görünebilir. Tarama, doğrulama ve senkron özelliklerinin tamamı ücretsiz sürümde eksiksizdir.

AI kural üreticisi hata veriyor

Belirti: doğal dilden kural üretirken hata alıyorsunuz. Neden: genellikle API anahtarı eksik/geçersizdir ya da kotanız dolmuştur.

  • Google AI Studio’dan aldığınız kendi Gemini API anahtarınızı uygulamaya girin; anahtar cihazda saklanır.
  • Anahtarın geçerli ve etkin olduğundan emin olun; “yetkisiz” türü hatalar genellikle yanlış veya süresi dolmuş anahtardan kaynaklanır.
  • Hesabınızın kotasını/limitini aşmadığınızı kontrol edin; kota dolduğunda istekler reddedilir.
  • İstek yalnızca siz isteyince ve yalnızca yazdığınız komutla gönderilir (görüntü gönderilmez). İnternet bağlantınızın açık olduğundan emin olun.

Daha fazlası için AI kural üreticisi sayfasına bakın.

Not: İzinlerin her biri yalnızca ilgili özelliği kullandığınızda devreye girer. Kamera tarama için, mikrofon sesle giriş için, internet ise yalnızca webhook senkronu ve AI kural üreticisi için gereklidir. Cihazda kalan ve ağa erişen veriler için Gizlilik sayfasına bakın.

QCR Scanner ReviseTouch tarafından geliştirilmiştir.

Sonraki adımlar