- 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 ตามงานข้างบน
109 lines
8.9 KiB
Markdown
109 lines
8.9 KiB
Markdown
# 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)
|