Skip to Content
Thêm nhân vật

Thêm nhân vật

Nhân vật mới dùng lại một dáng có sẵn không cần sửa C++: chỉ cần thêm một mục vào firmware/data/assistant.json.

1. Thêm dữ liệu

{ "id": "na", "name": "Na", "kind": "quả na xanh", "voice": "Zephyr", "tagline": "Tò mò, hay hỏi, thích khám phá", "persona": "Bạn là Na, một quả na xanh tò mò... Bạn xưng \"Na\" và gọi người dùng là \"bạn\".", "look": { "shape": "mochi", "body": "#A8D88A", "accent": "#6FA556", "ink": "#2F4022", "cheek": "#F5A77B" } }
TrườngBắt buộcQuy tắc
idcóChữ thường [a-z0-9_], tối đa 13 ký tự (lưu trong NVS dạng c_<id>). Không trùng; đừng đổi sau này.
namecóTên hiển thị. Người dùng nói tên này để đổi nhân vật.
voicecóGiọng có sẵn của Gemini Live: Leda, Aoede, Kore, Zephyr, Puck, Charon, Fenrir, Orus, Achird…
personacóNhân vật là ai, xưng hô thế nào. Một đoạn ngắn; common_rules được tự động nối thêm.
look.shapecócloud, corn, avocado, mochi hoặc robot
look.body/accent/ink/cheeknên có#RRGGBB. Nền màn hình tối (#15131F), nhớ kiểm tra độ tương phản.
kind, taglinenên cóMô tả ngắn và câu hiện khi chọn nhân vật
python3 firmware/scripts/validate_data.py

2. Ảnh xem trước trên web (tùy chọn)

Thiết bị tự vẽ gương mặt. Trang cài đặt hiện ảnh GIF xem trước do firmware/assets/make_faces.py tạo; thêm nhân vật vào bảng CHARACTERS của file đó rồi chạy:

uv run --with pillow python firmware/assets/make_faces.py firmware/assets/faces --only na firmware/build_assets.sh && firmware/flash_assets.sh

3. Dáng mới (chỉ khi cần)

Thêm một nhánh vào BuildBody() trong firmware/src/assistant/assistant_face.cc, dùng các hàm Shape(), Arc() và Hex() trong không gian thiết kế 320×320, thêm tên dáng vào KNOWN_SHAPES trong validate_data.py, và một hàm vẽ tương ứng trong make_faces.py. Kiểm tra đủ 23 biểu cảm; đường dẫn /screen.jpg cho bạn ảnh chụp màn hình.

4. Thử

firmware/build.sh && firmware/ota.sh bap-xxxx.local

Xoay núm, hoặc nói “cho mình gặp Na”.

Mẹo viết tính cách

  • Chốt cách nhân vật xưng hô với chính mình và với người dùng.
  • Tả giọng điệu bằng vài từ; danh sách câu cửa miệng dài sẽ bị lặp lại quá nhiều.
  • Mọi thứ đều được nói ra: không emoji, không định dạng.
  • Giữ dưới khoảng 1.500 byte vì nó được gửi ở mỗi phiên.
Last updated on