Hướng dẫn này cung cấp thông tin về cách giải quyết các lỗi cụ thể của SDK tiện ích bổ sung Google Meet mà bạn có thể gặp phải khi xây dựng và kiểm thử tiện ích bổ sung Meet.
Để biết thông tin chi tiết về một lỗi, hãy sử dụng đối tượng
MeetAddonError. Đối tượng này chứa thuộc tính
errorType
chỉ định loại lỗi.
Các loại lỗi
Sau đây là các loại lỗi được tạo khi SDK tiện ích bổ sung Meet đưa ra lỗi, cùng với giải thích về cách diễn giải các lỗi đó và hướng dẫn về những việc cần làm khi bạn gặp phải các lỗi này.
| Lỗi | Thông báo lỗi | Hành động |
|---|---|---|
ActivityIsOngoing |
Không thể thực hiện thao tác khi một hoạt động đang diễn ra. | Đảm bảo rằng không có hoạt động nào đang diễn ra. |
ActivityStartingStateEmpty |
Trạng thái bắt đầu hoạt động đang trống. | Một đối tượng ActivityStartingState đã được cung cấp, nhưng đối tượng này không chứa thuộc tính nào. |
ActivityStartingStateMissingAttributes |
Trạng thái bắt đầu hoạt động không chứa thuộc tính nào được nhận dạng. | Đảm bảo rằng đối tượng ActivityStartingState chứa ít nhất một trong các thuộc tính sau: mainStageUrl, sidePanelUrl hoặc additionalData. |
ActivityStartingStateUnrecognizedAttributes |
Trạng thái bắt đầu hoạt động chứa các thuộc tính không được nhận dạng. | Đảm bảo rằng đối tượng ActivityStartingState chỉ có các thuộc tính sau: mainStageUrl, sidePanelUrl hoặc additionalData. |
AddonSessionAlreadyCreated |
Phiên tiện ích bổ sung đã được tạo. | Chỉ tạo thực thể AddonSession một lần. |
AddonStartingStateMissingAttributes |
Trạng thái bắt đầu tiện ích bổ sung không chứa thuộc tính nào được nhận dạng. | Đảm bảo rằng đối tượng AddonStartingState chứa ít nhất một trong các thuộc tính sau: sidePanelUrl, additionalData. |
AddonStartingStateUnrecognizedAttributes |
Trạng thái bắt đầu tiện ích bổ sung chứa các thuộc tính không được nhận dạng. | Đảm bảo rằng đối tượng AddonStartingState chỉ có các thuộc tính sau: sidePanelUrl, additionalData. |
ArgumentNullError |
Giá trị của đối tượng được cung cấp là giá trị rỗng khi một giá trị được mong đợi. | Đảm bảo rằng bạn đang truyền giá trị thuộc loại dự kiến cho đối số. |
ArgumentTypeError |
Loại của đối tượng được cung cấp không khớp với loại dự kiến. | Đảm bảo rằng loại đối số được cung cấp khớp với loại dự kiến. |
DestinationNotReady |
Khung nhận không được kết nối bằng SDK tiện ích bổ sung Meet và không thể nhận thông báo. | Đảm bảo khung đích được kết nối trước khi gửi thông báo đến khung đó. |
InternalError |
Đã xảy ra lỗi nội bộ của Meet. | Không có thêm thông tin. |
InvalidActivityStartingState |
URL iframe ActivityStartingState không khớp với nguồn gốc của các URL được cung cấp trong tệp kê khai tiện ích bổ sung. |
Đảm bảo rằng nguồn gốc URL iframe ActivityStartingState khớp với nguồn gốc của các URL được cung cấp trong tệp kê khai tiện ích bổ sung. Để biết thêm thông tin, hãy xem bài viết Bảo mật tiện ích bổ sung. |
InvalidAddonStartingState |
URL iframe AddonStartingState không khớp với nguồn gốc của các URL được cung cấp trong tệp kê khai tiện ích bổ sung. |
Đảm bảo rằng nguồn gốc URL iframe AddonStartingState khớp với nguồn gốc của các URL được cung cấp trong tệp kê khai tiện ích bổ sung. |
InvalidCloudProjectNumber |
Số dự án trên đám mây do Meet cung cấp không khớp với số dự án do SDK tiện ích bổ sung Meet truyền vào. | Đảm bảo rằng số dự án trên đám mây chính xác được truyền vào SDK dưới dạng chuỗi khi gọi thuộc tính createAddonSession hoặc phương thức exposeToMeetWhenScreenSharing(). Tham số này được Meet tự động thêm vào mọi URL iframe. Đảm bảo rằng cơ sở hạ tầng của bạn không sửa đổi các tham số URL (ví dụ: trong quá trình chuyển hướng) trước khi sử dụng giá trị được truyền. |
MeetingPolicyPreventsStartingActivity |
Một chính sách cuộc họp (chẳng hạn như sử dụng chế độ cài đặt kiểm soát của người tổ chức) ngăn người dùng bắt đầu hoạt động. | Yêu cầu người tổ chức hoặc quản trị viên cuộc họp sửa đổi các chế độ cài đặt cần thiết để cho phép người dùng hiện tại bắt đầu hoạt động. |
MissingUrlParameter |
Thiếu tham số URL bắt buộc của SDK tiện ích bổ sung Meet. | Tham số này được Meet tự động thêm vào URL iframe. Đảm bảo rằng cơ sở hạ tầng của bạn không sửa đổi các tham số URL (ví dụ: trong quá trình chuyển hướng). |
NeedsMainStageContext |
Bạn chỉ có thể gọi phương thức này nếu tiện ích bổ sung đang chạy ở giai đoạn chính. | Sử dụng thuộc tính getFrameType để kiểm tra xem tiện ích bổ sung có đang chạy ở giai đoạn chính hay không trước khi gọi phương thức này. |
NeedsSidePanelContext |
Bạn chỉ có thể gọi phương thức này nếu tiện ích bổ sung đang chạy trong bảng điều khiển bên. | Sử dụng thuộc tính getFrameType để kiểm tra xem tiện ích bổ sung có đang chạy trong bảng điều khiển bên hay không trước khi gọi phương thức này. |
NoActivityFound |
Không tìm thấy hoạt động nào khi thực hiện thao tác. | Đảm bảo rằng hoạt động đã bắt đầu trước khi thực hiện thao tác này. |
NotSupportedInMeetCall |
Phương thức này không được hỗ trợ trong cuộc gọi Meet. | Không gọi phương thức này trong cuộc gọi Meet. |
NotSupportedInStandalone |
Phương thức này không được hỗ trợ ở chế độ độc lập. | Không gọi phương thức này ở chế độ độc lập. |
RequiresEapEnrollment |
Phương thức được yêu cầu cần phải đăng ký EAP. | Đã đóng chương trình đăng ký quyền truy cập sớm vào tiện ích bổ sung Google Meet. |
SizeLimitExceededActivityStartingState |
Kích thước của URL ActivityStartingState và/hoặc dữ liệu của URL này vượt quá giới hạn cho phép. |
Đảm bảo rằng kích thước URL ActivityStartingState nhỏ hơn 512 ký tự và kích thước dữ liệu bổ sung nhỏ hơn 4.096 ký tự. |
SizeLimitExceededAddonStartingState |
Kích thước của URL AddonStartingState và/hoặc dữ liệu của URL này vượt quá giới hạn cho phép. |
Đảm bảo rằng kích thước URL AddonStartingState nhỏ hơn 512 ký tự và kích thước dữ liệu bổ sung nhỏ hơn 4.096 ký tự. |
SizeLimitExceededFrameToFrameMessage |
Kích thước của thông báo từ khung đến khung vượt quá giới hạn cho phép. | Đảm bảo rằng kích thước thông báo từ khung đến khung nhỏ hơn 1.000.000 ký tự. |
UserCancelled |
Người dùng đã huỷ việc bắt đầu hoạt động. | Người dùng cần nhấp vào Tiếp tục để bắt đầu hoạt động. |
UserNotInitiator |
Người dùng không phải là người khởi xướng hoạt động hiện tại. | Đảm bảo rằng người dùng là người khởi xướng hoạt động hiện tại hoặc hoạt động đã kết thúc. |