Vấn Đề Thường Gặp

1. Xuất Thất Bại Với "Asset Not Found"

Triệu chứng: Quy trình xuất dừng lại với lỗi tham chiếu tài nguyên thiếu.

Giải pháp:

• Mở variant và kiểm tra tab Assets xem có tham chiếu bị hỏng không (hiển thị biểu tượng cảnh báo)
• Tải lại tài nguyên bị thiếu hoặc thay thế tham chiếu bằng tài nguyên hiện có
• Xác nhận tài nguyên thuộc cùng tổ chức với game

2. Tải File Bị Từ Chối

Triệu chứng: Tải tài nguyên thất bại hoặc hiện lỗi "unsupported format".

Giải pháp:

• Kiểm tra định dạng file được hỗ trợ (PNG, JPG, WebP, SVG, MP3, OGG, WAV, JSON)
• Đảm bảo file dưới giới hạn dung lượng (100 MB mỗi file)
• Thử trình duyệt khác nếu thanh tiến trình tải lên bị treo
• Xóa cache trình duyệt và thử lại

3. Lỗi "Unauthorized" (401)

Triệu chứng: Yêu cầu API hoặc tải trang trả về lỗi 401.

Giải pháp:

• Web app: Session có thể đã hết hạn. Đăng xuất và đăng nhập lại
• API token: Xác nhận token chưa bị thu hồi tại Developers > Tokens
• Kiểm tra header Authorization: Bearer <token> đúng định dạng

4. Lỗi "Permission Denied" (403)

Triệu chứng: Hành động bị chặn với thông báo "insufficient permissions".

Giải pháp:

• Xác nhận vai trò của bạn trong tổ chức (Người xem, Thành viên, Quản lý, Quản trị viên, Chủ sở hữu) trong thanh bên tại Members
• Với API token, kiểm tra token có phạm vi quyền cần thiết
• Nhờ admin tổ chức nâng cấp vai trò của bạn nếu cần

5. File Xuất Quá Lớn Cho Mạng Quảng Cáo

Triệu chứng: Quảng cáo playable xuất ra vượt giới hạn dung lượng của mạng quảng cáo.

Giải pháp:

• Nén texture trước khi tải lên (dùng WebP thay PNG khi có thể)
• Giảm chất lượng audio hoặc dùng clip ngắn hơn
• Xóa tài nguyên không sử dụng khỏi variant
• Kiểm tra giới hạn dung lượng của từng mạng quảng cáo trong cài đặt xuất

6. Thay Đổi Không Hiển Thị Sau Khi Lưu

Triệu chứng: Tùy chỉnh hoặc cài đặt đã lưu không phản ánh trong preview hoặc xuất.

Giải pháp:

• Làm mới trình duyệt (Ctrl+Shift+R hoặc Cmd+Shift+R)
• Kiểm tra bạn đã lưu thay đổi vào đúng variant (không phải version khác)
• Xác nhận preview đang tải phiên bản mới nhất bằng cách kiểm tra thời gian

7. Email Mời Không Nhận Được

Triệu chứng: Thành viên nhóm nói không nhận được email mời.

Giải pháp:

• Kiểm tra thư mục spam/junk của người nhận
• Xác nhận địa chỉ email nhập đúng tại trang Members qua Invite Member
• Gửi lại lời mời từ trang quản lý nhóm
• Nhờ người nhận thêm noreply@playablelabs.studio vào danh bạ

8. Tích Hợp ClickUp Không Đồng Bộ

Triệu chứng: Sự kiện trong PlayableLabs không tạo hoặc cập nhật task ClickUp.

Giải pháp:

• Tích hợp này được quản lý bởi quản trị viên hệ thống — liên hệ admin của bạn
• Xác nhận ClickUp API token vẫn còn hiệu lực trong bảng admin
• Kiểm tra ClickUp workspace và list đích vẫn tồn tại

9. Tải Trang Chậm Hoặc Timeout

Triệu chứng: Bảng điều khiển hoặc trình soạn game mất quá lâu để tải.

Giải pháp:

• Kiểm tra tốc độ kết nối internet
• Giảm số tài nguyên hiển thị mỗi trang bằng điều khiển phân trang
• Xóa cache trình duyệt và tắt extension không cần thiết
• Thử trình duyệt khác (khuyến nghị Chrome)

10. Vượt Giới Hạn API Rate Limit (429)

Triệu chứng: Yêu cầu API trả về 429 Too Many Requests.

Giải pháp:

• Giảm tần suất request để nằm trong giới hạn
• Áp dụng exponential backoff trong API client
• Sử dụng header Retry-After để xác định thời điểm thử lại
• Gộp các thao tác khi có thể thay vì gửi từng request riêng lẻ

Vẫn Cần Hỗ Trợ?

Nếu vấn đề của bạn không có trong danh sách, xem FAQ hoặc liên hệ hỗ trợ tại support@playablelabs.studio.