Hỗ trợ

Đã cấp quyền nhưng vẫn không gõ được

KeyVi cần quyền để nhận phím gõ. Tên mục thay đổi theo phiên bản macOS:

• macOS 12: Tùy chọn Hệ thống > Bảo mật & Quyền riêng tư > Quyền riêng tư > Trợ năng (bấm vào ổ khóa để thay đổi).
• macOS 13 tới 26: Cài đặt hệ thống > Quyền riêng tư & Bảo mật > Trợ năng.
• macOS 27: Cài đặt hệ thống > Quyền riêng tư & Bảo mật > Điều khiển thiết bị và truy cập dữ liệu (tên tiếng Anh: Device Control and Data Access; trước đây là Accessibility). VERIFY

1. Bảo đảm KeyVi nằm trong thư mục /Applications (hoặc ~/Applications), không chạy từ DMG.
2. Bật công tắc của KeyVi trong mục trên. Ứng dụng tự nhận ra trong vòng vài giây.
3. Công tắc đã bật nhưng không có tác dụng (thường xảy ra sau khi cập nhật macOS): chọn KeyVi trong danh sách, bấm nút trừ (-) để xoá, rồi thêm lại. Hoặc dùng nút Đặt lại quyền trong ứng dụng, chỉ đặt lại quyền của riêng KeyVi.
4. Muốn tự làm trong Terminal: tccutil reset Accessibility vn.kal.keyvi. Luôn ghi kèm mã định danh ứng dụng. Đừng chạy sudo tccutil reset Accessibility không kèm mã định danh, vì lệnh đó xoá quyền của mọi ứng dụng. VERIFY Tên dịch vụ có thể khác trên macOS 27.

Trong lúc thiếu quyền, bàn phím vẫn gõ bình thường; KeyVi chỉ tạm dừng và không chặn phím.

Gõ tiếng Việt bị tạm dừng, menu báo "chế độ nhập bảo mật"

Khi một ứng dụng bật Secure Event Input của macOS, hệ thống ngừng gửi phím cho mọi bộ gõ chạy nền, không riêng gì KeyVi. Thường là do một ô mật khẩu còn mở. KeyVi chỉ tạm dừng khi macOS báo chế độ này đang bật hoặc khi ô đang chọn thật sự là ô mật khẩu. KeyVi không đoán, và tiếp tục ngay ở phím đầu tiên sau khi chế độ này tắt.

Menu của KeyVi nêu ứng dụng có thể đang giữ chế độ này (đây là phỏng đoán tốt nhất, đôi khi chưa chính xác):

• Terminal: trong menu Terminal, tắt Secure Keyboard Entry.
• iTerm2: iTerm2 đang bật Nhập bàn phím an toàn. Hãy tắt mục iTerm2 > Secure Keyboard Entry, hoặc nhập xong (hay huỷ) lời nhắc mật khẩu đang chờ.
• Trình duyệt: bấm ra ngoài ô mật khẩu hoặc đổi sang thẻ khác.
• Trình quản lý mật khẩu hoặc ứng dụng khác: đóng cửa sổ nhập mật khẩu của nó.
• Không biết ứng dụng nào, hoặc menu chỉ ra loginwindow: khoá màn hình rồi mở lại (Control + Command + Q), hoặc đăng xuất rồi đăng nhập lại.

Chữ bị lặp hoặc mất

Hai bộ gõ chạy cùng lúc sẽ làm lặp hoặc mất chữ. Bạn nên thoát bộ gõ kia và tắt nó khi đăng nhập. KeyVi sẽ báo khi phát hiện, nhưng không tự thoát hay chỉnh ứng dụng khác.

1. Thoát bộ gõ cũ (XKey, OpenKey, EVKey, Gõ Nhanh, PHTV hoặc tương tự) từ biểu tượng trên thanh menu.
2. Cài đặt hệ thống > Cài đặt chung > Mục đăng nhập & tiện ích mở rộng: xoá bộ gõ cũ khỏi danh sách mở khi đăng nhập. VERIFY
3. Nếu bạn đang bật bộ gõ Tiếng Việt có sẵn của macOS, hãy chọn bàn phím ABC hoặc U.S. khi dùng KeyVi.

Hướng dẫn riêng cho từng ứng dụng nằm ở mục chuyển từ bộ gõ khác.

Chỉ lỗi ở một ứng dụng

1. Xem ứng dụng đó trong danh sách tương thích: có thể đã có ghi chú hoặc cách xử lý.
2. Thử gõ trong ô gõ thử của KeyVi (nút Thử trong ô gõ thử khi báo lỗi) để biết lỗi chỉ xảy ra ở ứng dụng đó hay ở mọi nơi.
3. Trong menu KeyVi, mục Với tên ứng dụng có thể đặt Luôn tiếng Anh hoặc Bỏ qua ứng dụng này nếu bạn cần làm việc ngay.
4. Báo lỗi bằng Báo lỗi với ứng dụng này...: báo cáo tự điền sẵn ứng dụng, phiên bản và quy tắc đang áp dụng.

Phím chuyển trùng với phím tắt của macOS

Nếu bạn chọn một tổ hợp phím mà macOS đang dùng, KeyVi vẫn lưu lựa chọn và hiện cảnh báo nêu tính năng của macOS dùng tổ hợp đó. Để tổ hợp chỉ dành cho KeyVi, hãy tắt hoặc đổi phím tắt đó trong macOS:

1. Mở Cài đặt hệ thống > Bàn phím, bấm Phím tắt bàn phím.... VERIFY Tên mục tiếng Việt trên từng phiên bản macOS.
2. Chọn nhóm ở cột bên trái (xem danh sách dưới đây), rồi bỏ chọn ô của phím tắt để tắt nó, hoặc bấm đúp vào tổ hợp phím để gán tổ hợp khác.

• Command + Space: nhóm Spotlight, mục hiện tìm kiếm Spotlight.
• Control + Space và Control + Option + Space: nhóm Nguồn nhập, mục chọn nguồn nhập trước đó và mục chọn nguồn tiếp theo. VERIFY Tên nhóm tiếng Việt.
• Control + Command + Space: mở bảng Emoji và ký hiệu. Phím tắt này nằm trong menu Sửa của từng ứng dụng, không có trong các nhóm trên; bạn có thể gán tổ hợp khác cho mục menu đó ở nhóm Phím tắt ứng dụng. VERIFY Tên mục menu và nhóm trên từng phiên bản macOS.
• Command + Tab (chuyển ứng dụng), Command + Q (thoát ứng dụng) và Command + W (đóng cửa sổ): macOS không cho tắt các phím tắt này. Bạn nên chọn tổ hợp khác cho KeyVi.

KeyVi không đọc cài đặt phím tắt của macOS, nên cảnh báo trong Cài đặt vẫn hiện sau khi bạn đã tắt phím tắt đó. Khi đó bạn có thể bỏ qua cảnh báo.