Hướng dẫn này cung cấp hướng dẫn về cách giải quyết các lỗi SDK cụ thể của tiện ích bổ sung Google Meet mà bạn có thể gặp phải trong khi tạo 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. Tệp 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 gửi lỗi, cùng với nội dung giải thích về cách diễn giải các lỗi đó và hướng dẫn về việc cần làm khi bạn gặp lỗi.
| Lỗi | Thông báo lỗi | Hành động |
|---|---|---|
ActivityIsOngoing |
Không thể thực hiện thao tác trong khi một hoạt động đang diễn ra. | Đảm bảo một hoạt động không đang diễn ra. |
ActivityStartingStateEmpty |
Trạng thái bắt đầu hoạt động đang trống. | Đố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 bất kỳ 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 bản sao AddonSession một lần. |
AddonStartingStateMissingAttributes |
Trạng thái bắt đầu của tiện ích bổ sung không chứa bất kỳ 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 của 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à rỗng trong khi dự kiến là một giá trị. | Đảm bảo bạn đang truyền một 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 loại đối số được cung cấp khớp với loại dự kiến. |
DestinationNotReady |
Khung người 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ộ trong Meet. | Không có thêm thông tin nào. |
InvalidActivityStartingState |
URL iframe ActivityStartingState không khớp với nguồn gốc của 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 phần 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 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 được SDK tiện ích bổ sung của Meet truyền vào. | Đảm bảo rằng số dự án trên Google Cloud 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(). Meet sẽ tự động thêm tham số này vào mọi URL iframe. Hãy đả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ị đã truyền. |
MissingUrlParameter |
Thiếu tham số URL SDK bắt buộc của tiện ích bổ sung Meet. | Meet sẽ tự động thêm tham số này vào URL iframe. Đảm bảo 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 trong 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 trong 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 một thao tác. | Hãy đả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 trên Meet. | Đừng gọi phương thức này trong cuộc gọi trên 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 yêu cầu đăng ký EAP. | Chúng tôi đã ngừng đăng ký sử dụng sớm 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 đó vượt quá giới hạn cho phép. |
Đảm bảo rằng kích thước URL ActivityStartingState ít hơn 512 ký tự và kích thước dữ liệu bổ sung ít hơn 4.096 ký tự. |
SizeLimitExceededAddonStartingState |
Kích thước của URL AddonStartingState và/hoặc dữ liệu của URL đó 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 khung hình với khung hình 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 hình này sang khung hình khác nhỏ hơn 1.000.000 ký tự. |
UserCancelled |
Người dùng đã huỷ 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 tạo hoạt động hiện tại. | Đảm bảo rằng người dùng là người khởi tạo hoạt động hiện tại hoặc hoạt động đã kết thúc. |