Files
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

109 lines
8.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` | ชื่อเต็ม ถ้าใส่จะใช้ค่านี้แทนการประกอบชื่อ |
ตัวอย่าง:
```csv
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 แล้วเห็นค่าพวกนี้ทันที
## รันทดสอบ
```bash
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)