Files
web-camera-category/app
Bkk1234 6f146aef59 feat(android): Capacitor APK build + native save/share bridge
- android/ — Capacitor project (build/, local.properties ignored)
- app/js/native.js — bridge สำหรับ APK: savePhoto/saveZip/shareItems ผ่าน Filesystem+Share
- app/js/csv.js — นำเข้าโฟลเดอร์หลายรายการจาก CSV (site,letter,datetime,name)
- app/js/orient.js — จัดการ orientation ของ preview/กล้อง
- app/manual.html + APK.md — คู่มือใช้งานและวิธี build APK
- app/templates/folders-template.csv — เทมเพลต CSV
- package.json / package-lock.json / capacitor.config.json / scripts/build-apk.sh
- ปรับ ui, camera, exif, archive, db, naming, main, sw + css/README ตามงานข้างบน
2026-11-20 08:50:42 +07:00
..
2026-10-24 17:32:25 +07:00
2026-10-24 17:32:25 +07:00

CamCat — Web Camera Category PWA (One UI)

PWA ถ่ายรูปหน้างาน แยกโฟลเดอร์ตามไซต์ พร้อม Metadata, ZIP ทั้งโฟลเดอร์ และแชร์ผ่านระบบของมือถือ หน้าตาออกแบบตามภาษา Samsung One UI (การ์ดมุมโค้ง 26px, พิลล์, ธีมสว่าง/มืด, ไอคอน SVG ล้วน)

Features

  • กล้องหลัง/หน้า, ไฟแฟลช (torch), ซูมแบบ pills 1×/2×/3×, เส้นแบ่ง 3 ส่วน, อัตราส่วนภาพ 4:3 / 3:4 (ครอปจริง)
  • จัดทิศทางภาพอัตโนมัติ (EXIF Orientation → หมุนพิกเซล → Orientation=1) + ปุ่มหมุนซ้าย/ขวาในชีตรูป
  • APK: ปุ่มเพิ่ม/ลดเสียง = ชัตเตอร์, ล็อกแนวตั้ง
  • ถ่ายด้วย ImageCapture.takePhoto() (ความละเอียดเต็ม) fallback เป็น canvas
  • เขียน EXIF มาตรฐานลงไฟล์จริงก่อนบันทึก (Make/Model/Software/DateTimeOriginal/ExifVersion/ColorSpace/Resolution/ImageUniqueID + GPS ละเอียด/เวลา/ความแม่นยำ) → ติดไปตอนแชร์
  • โฟลเดอร์ชื่อเริ่มต้นอัตโนมัติ: Site <ตัวอักษร> <ปี พ.ศ.>.<เดือน>.<วัน>.<ชั่วโมง>.<นาที>
    • ตัวอักษรไล่ a…z แล้วต่อ aa, ab … az, ba … (แบบคอลัมน์ Excel)
    • ปุ่ม + บนหัวแอป = สร้างทันที · ปุ่ม "โฟลเดอร์ใหม่" = เปิดชีตแก้ชื่อก่อนสร้าง · เปลี่ยนชื่อทีหลังได้ (ปุ่มดินสอ)
  • นำเข้าโฟลเดอร์ทีละหลายรายการจาก CSV (ดูหัวตารางด้านล่าง) — ไฟล์เปล่า: templates/folders-template.csv
  • ZIP ทุกรูปในโฟลเดอร์ (มีแต่ JPEG — metadata อยู่ใน EXIF ของแต่ละไฟล์) แล้วดาวน์โหลดลงเครื่อง
    • โครงสร้างใน zip = <ชื่อโฟลเดอร์>/<ไฟล์>.jpg → แตกออกมาเป็นโฟลเดอร์จริง
  • ปุ่ม ZIP ทุกโฟลเดอร์ ที่หน้าโฟลเดอร์ → ไฟล์เดียว CamCat-all-<stamp>.zip แยกโฟลเดอร์ย่อยครบทุกโฟลเดอร์
  • ปุ่ม ZIP = รวมทุกรูปในโฟลเดอร์แล้วดาวน์โหลดลงเครื่อง (ปุ่มแชร์ ZIP ถูกถอดออกตามคำสั่ง)
  • ธีมสว่าง/มืด/ตามระบบ (จำค่าไว้), safe-area, 100dvh, ปุ่ม ≥44px ตาม One UI
  • QR ลิงก์ทดสอบบนมือถือ (ต้อง HTTPS) + หน้าข้อมูลอุปกรณ์/กล้อง (diagnostics)
  • Offline: Service Worker + IndexedDB, ติดตั้งเป็น PWA ได้
  • คู่มือใช้งานหน้าเดียว (standalone HTML, พิมพ์/บันทึก PDF ได้): manual.html → เปิดที่ /manual.html

Design (One UI)

องค์ประกอบ ค่า
สีหลัก light bg #F2F3F5 · card #FFFFFF · text #101114 · accent #0A72DE
สีหลัก dark bg #000000 · card #1B1B1D · text #F2F3F5 · accent #4E9DFF
มุมโค้ง การ์ด 26px · ช่องกรอก 16px · ปุ่ม/ชิปเป็น pills
ตัวอักษร One UI Sans → SF / Segoe / Roboto / Noto Sans Thai
ระยะ 4/8px rhythm, ขอบข้าง 20px
Accessibility ข้อความ ≥4.5:1, ปุ่ม ≥44px, reduced-motion, focus ring
หน้าเมนูกล้อง โครมดำทั้งหน้าแบบ One UI Camera

นำเข้าโฟลเดอร์จาก CSV

หัวตาราง 4 คอลัมน์ (ทุกคอลัมน์เว้นว่างได้):

คอลัมน์ ความหมาย
site คำนำหน้า เช่น Site (เว้นว่าง = Site)
letter a…z, aa… (เว้นว่าง = ไล่ต่อจากโฟลเดอร์ที่มีอยู่ให้อัตโนมัติ)
datetime 2569.10.25.21.45 (รับ - / : หรือ ค.ศ. ได้ เช่น 2026-10-25 21:45)
name ชื่อเต็ม ถ้าใส่จะใช้ค่านี้แทนการประกอบชื่อ

ตัวอย่าง:

site,letter,datetime,name
Site,a,2569.10.25.21.45,
Site,b,2569.10.25.22.10,
Site,,2569.10.26.08.00,หน้างานพิเศษ

กติกาที่ระบบบังคับ: letter ต้อง a-z · datetime ต้องอ่านเป็นวันเวลาได้ · ชื่อซ้ำจะถูกข้ามพร้อมรายงานแถวที่ผิด

ปุ่มแชร์ ZIP (Web Share)

  1. ZIP ถูกสร้างล่วงหน้าหลังเปิดแกลเลอรี → กด "แชร์ ZIP" แล้วเรียก navigator.share({files}) ทันทีในจังหวะแตะ (ไม่ให้ user activation หมดอายุ)
  2. ถ้ายังไม่มี ZIP / เบราว์เซอร์ตัดสิทธิ์ → เปิดชีต "ZIP พร้อมแล้ว" ให้กด "แชร์ไปแอปอื่น" อีกครั้ง (activation ใหม่) หรือ "บันทึกไฟล์"
  3. เบราว์เซอร์ที่ไม่รองรับแชร์ไฟล์ (เช่น Samsung Internet บางเวอร์ชัน) → ปุ่มแชร์ถูกปิด พร้อมปุ่มบันทึกไฟล์แทน

EXIF ที่ฝังในไฟล์ (per photo)

IFD tag
IFD0 270 ImageDescription (CamCat · <โฟลเดอร์>) · 271 Make samsung · 272 Model SM-S911B · 274 Orientation · 282/283/296 Resolution · 305 Software · 306 DateTime
Exif 36864 ExifVersion 0232 · 36867/36868 DateTimeOriginal/Digitized · 37121 ComponentsConfiguration · 37380 ExposureBias · 40961 ColorSpace sRGB · 40962/40963 Pixel dims · 41985–41994 (rendering modes) · 42016 ImageUniqueID
GPS 0 Version · 1/2 LatRef+Lat · 3/4 LonRef+Lon · 5/6 Altitude · 7 TimeStamp · 27 ProcessingMethod · 29 DateStamp · 31 HPositioningError (±เมตร)

ไม่มีไฟล์ JSON แยก — เปิดรูปด้วยแอป Samsung Gallery / Google Photos / exiftool แล้วเห็นค่าพวกนี้ทันที

รันทดสอบ

cd app
python -m http.server 8099 --bind 0.0.0.0

# กล้องใช้ได้เฉพาะ HTTPS — เปิด tunnel แล้วสแกน QR ในแอป
cloudflared tunnel --url http://127.0.0.1:8099

Files

app/
├── index.html          # shell + header/nav แบบ One UI
├── css/app.css         # design tokens + components (light/dark)
├── js/config.js        # ค่าคงที่ (Site A, timezone, quality)
├── js/naming.js        # ชื่อโฟลเดอร์/ไฟล์ ปี พ.ศ.
├── js/db.js            # IndexedDB (folders, images, thumbs)
├── js/exif.js          # อ่าน/เขียน EXIF (piexifjs)
├── js/device.js        # ตรวจรุ่นเครื่อง (SM-S911B → Galaxy S23)
├── js/camera.js        # getUserMedia, ImageCapture, torch, zoom
├── js/archive.js       # ZIP + ดาวน์โหลด + Web Share (มี cache)
├── js/ui.js            # markup + bottom sheet + toast
├── js/main.js          # state, events, ธีม, diagnostics
├── vendor/             # jszip, piexif, qrcode (ใช้ offline)
├── sw.js · manifest.json · icon-*.png
└── README.md

Browser

Chrome/Edge Android (Samsung S23 คือเครื่องทดสอบหลัก) · Safari 16+ (ไม่มี torch/zoom)