Mã nguồn Chánh Điện Online

Chánh Điện Online là bộ mã nguồn dựng một chánh điện 2.5D để phát trên TikTok LIVE. Mỗi người xem bình luận sẽ bước vào chánh điện và ngồi xuống bồ đoàn. Ai tặng quà được xướng tên hồi hướng bằng giọng đọc tiếng Việt, kèm nhạc thiền, chuông, mõ và đọc kinh định kỳ.

Dự án gốc do Kent Juno viết và chia sẻ theo giấy phép MIT. Link trên trang này dẫn đến bản Bear, một bản fork vẫn giữ giấy phép và ghi công tác giả gốc, có thêm file chạy nhanh trên Windows và phần cài API key ngay trong bảng điều khiển.

Bộ mã nguồn gồm những gì

• Bản web tĩnh (index.html, assets/): trang cho mọi người tự vào ngồi tụng, đăng được lên Cloudflare Pages. Nút quà ở bản này chỉ mô phỏng, số người và bảng xếp hạng ban đầu là dữ liệu mẫu.
• Bộ phát LIVE (live/): server Node chạy trên máy phát, màn hình overlay 9:16 và bảng điều khiển.

Người xem làm được gì trên LIVE

• Bình luận bất kỳ: được vào ngồi, tối đa 100 chỗ. Khi đầy, người im lặng lâu nhất và chưa tặng quà sẽ nhường chỗ.
• Bình luận đúng một từ như nam, nữ, sư, ni, tiểu, bà, cao tăng: đổi hình nhân vật.
• Tặng quà: hiện banner, đọc tên hồi hướng, thêm hiệu ứng theo giá trị quà và cộng điểm vào bảng Công Đức.
• Thả tim: tim bay trên đầu nhân vật.

Cần lưu ý về bản quyền

Theo README, hình ảnh được tạo bằng Google Flow và nhạc nền tạo bằng Gemini. Giấy phép MIT áp dụng cho mã nguồn, còn nếu dùng thương mại bạn nên kiểm tra điều khoản của hai dịch vụ đó hoặc thay bằng tài nguyên của mình. Khi phân phối lại, hãy giữ file LICENSE.

Bạn cần cài Node.js 20 trở lên. Máy phát phải có Internet vì giọng đọc dùng dịch vụ của Microsoft Edge.

Cách nhanh trên Windows

1. Tải mã nguồn về và giải nén.
2. Nhấp đúp run.bat. File này tự cài thư viện rồi mở trang web và bảng điều khiển.

Cách chạy bằng dòng lệnh

cd live
npm install
npm start

Sau đó mở http://localhost:3000/live/control.html.

Kết nối TikTok LIVE

1. Trong bảng điều khiển, bấm Mở màn hình overlay 9:16, rồi bấm Bật âm thanh một lần trong cửa sổ đó.
2. Trong TikTok LIVE Studio, thêm nguồn Window capture và chọn cửa sổ overlay. Nếu dùng OBS, thêm Browser source trỏ tới http://localhost:3000/live/overlay.html, kích thước 1080×1920.
3. Bật LIVE trên TikTok, nhập @username vào bảng điều khiển rồi bấm Kết nối.

Chưa live vẫn thử được bằng các nút Thử tương tác, Đổ người mẫu hoặc Bot mô phỏng.

Nếu báo hết lượt

TikTok yêu cầu ký đường kết nối live, và thư viện nhờ máy chủ Euler Stream làm việc này. Không có key vẫn chạy nhưng bị giới hạn lượt. Khi nhật ký báo hết lượt, hãy lấy API key tại eulerstream.com rồi dán vào mục Nguồn đọc live · API key trong bảng điều khiển.