Hướng dẫn này cung cấp thông tin hướng dẫn 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 trong khi tạo và kiểm thử tiện ích bổ sung Meet.
Để xem 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 một 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 Meet Add-ons SDK gặp 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 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 trong khi một hoạt động đang diễn ra. | Đảm bảo rằng một hoạt động không diễn ra liên tục. |
ActivityStartingStateEmpty |
Trạng thái bắt đầu của hoạt động là trống. | Bạn đã cung cấp một đối tượng ActivityStartingState nhưng đối tượng này không có thuộc tính nào. |
ActivityStartingStateMissingAttributes |
Trạng thái bắt đầu của 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 của hoạt động chứa các thuộc tính không xác định. | Đả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ỉ khởi tạo 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 mà hệ thống 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 được cung cấp là rỗng trong khi bạn dự kiến có 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 đố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 Meet Add-ons SDK và không thể nhận được 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. |
InvalidActivityStartingState |
ActivityStartingState URL iframe không khớp với nguồn gốc của URL có trong tệp kê khai tiện ích bổ sung. |
Đảm bảo rằng nguồn gốc URL của iframe ActivityStartingState khớp với nguồn gốc của các URL được cung cấp trong tệp kê khai của 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 |
AddonStartingState URL iframe không khớp với nguồn gốc của URL có trong tệp kê khai tiện ích bổ sung. |
Đảm bảo rằng nguồn gốc URL của iframe AddonStartingState khớp với nguồn gốc của các URL được cung cấp trong tệp kê khai của 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 Meet Add-ons SDK truyền vào. | Đảm bảo rằng số dự án trên Cloud chính xác được truyền vào SDK dưới dạng một 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ị được truyền. |
MeetingPolicyPreventsStartingActivity |
Một chính sách về cuộc họp (chẳng hạn như sử dụng chế độ cài đặt quyền 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 cuộc họp hoặc quản trị viên 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 Meet Add-ons SDK. | Meet 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 ở 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 một 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 qua Meet. | Đừng gọi phương thức này trong cuộc gọi qua 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 có chế độ đăng ký EAP. | Đã đóng quy trình đăng ký sử dụng sớm tiện ích bổ sung Google Meet. |
SizeLimitExceededActivityStartingState |
Kích thước của các 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 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 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 giữa các 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 giữa các khung hình 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 bắt đầu 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. |