Hướng dẫn này cung cấp hướng dẫn về cách khắc phục các lỗi cụ thể của SDK Tiện ích Google Meet mà bạn có thể gặp phải trong khi tạo và kiểm thử Tiện ích Meet.
Để biết thông tin chi tiết về 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 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. | Đã cung cấp đối tượng ActivityStartingState 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 nhận dạng được. | Hãy đảm bảo đố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 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 nhận dạng được. | Đả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 đã cung cấp là rỗng khi giá trị được mong đợi. | Đả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 của 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 |
ActivityStartingState URL iframe 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. |
Hãy đảm bảo rằng các 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 Meet chuyển. | Đả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 tự động thêm tham số này vào bất kỳ URL iframe nào. Hãy đảm bảo cơ sở hạ tầng của bạn không sửa đổi các tham số URL (ví dụ như một phần của lệnh chuyển hướng) trước khi sử dụng giá trị đã truyền. |
MissingUrlParameter |
Thiếu tham số URL SDK của tiện ích bổ sung Meet bắt buộc. | 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 yêu cầu cần đăng ký EAP. | Chúng tôi đã ngừng đăng ký sử dụng sớm tiện ích bổ sung của 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 các 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. |