Làm ứng dụng web chạy bên trong Zoom
zoom-apps-sdk
Tài liệu tham khảo Zoom Apps SDK để làm ứng dụng web chạy trong cuộc họp, webinar, ứng dụng Zoom chính hoặc Zoom Phone, gồm đăng nhập OAuth, khai báo quyền và ví dụ khởi đầu.
Tải miễn phí. Theo dõi Skilnexa một lần là mở khoá mọi lượt tải trên web.
Nó là gì
Tài liệu tham khảo để làm ứng dụng web chạy bên trong Zoom (cuộc họp, hội thảo, ứng dụng chính) bằng Zoom Apps SDK, gồm đăng nhập trong Zoom và lớp vẽ video. Chỉ hợp lập trình viên web; cần khai báo tên miền được phép trong Marketplace.
Hoạt động ra sao
Mã đầu tiên gọi config() để khai báo mọi khả năng cần dùng, rồi xem ngữ cảnh chạy (trong họp, ứng dụng chính...). Nếu cần đăng nhập, dùng OAuth PKCE ngay trong Zoom và kiểm tra tham số state. Kết quả là ứng dụng chạy được trong Zoom, có trang xem trước khi mở ngoài Zoom.
Ví dụ ứng dụng
- Tình huống
- Công ty muốn nhân viên mở bảng theo dõi dự án ngay trong cuộc họp Zoom, không phải chuyển tab.
- Bạn đưa vào
- Tên miền ứng dụng đã thêm vào danh sách cho phép, Client ID, Secret và danh sách khả năng cần dùng.
- Bạn nhận được
- Ứng dụng web hiện trong khung bên cạnh cuộc họp; khi mở ngoài Zoom thì hiện trang xem trước.
Ví dụ minh họa theo quy trình trong tài liệu gốc, chưa phải kết quả thử chạy.
Dùng khi nào
Khi muốn đặt thêm bảng ghi chú riêng của công ty ngay bên cạnh cuộc họp Zoom.
Các phần chính trong hướng dẫn
- Tổng quan SDK
- Bắt đầu nhanh
- Cài bằng NPM hoặc CDN
- Xung đột biến toàn cục
- Chế độ xem thử trên trình duyệt
- Danh sách URL cho phép (bắt buộc)
- Phạm vi quyền OAuth (bắt buộc)
- Ngữ cảnh chạy
Xem mô tả gốc của tác giả (tiếng Anh)
Reference skill for Zoom Apps SDK. Use after routing to an in-client app workflow when building web apps that run inside Zoom meetings, webinars, the main client, or Zoom Phone.
Chi tiết tính năng
- Only APIs listed in
config({ capabilities: [...] })are available. Calling an unlisted API throws an error. This is also true for event listeners. zoomSdk.config()throws outside the Zoom client. Always wrap in try/catch with browser fallback:- Free ngrok URLs change on restart. You must update 4 places in Marketplace: Home URL, Redirect URL, OAuth Allow List, Domain Allow List. Consider ngrok paid plan for stable subdomain.
- Use
zoomSdk.authorize()(In-Client) for best UX - no browser redirect. Only fall back to web redirect for initial install from Marketplace. - Camera mode uses CEF which takes time to initialize.
drawImage/drawWebViewmay fail if called too early. Implement retry with exponential backoff. - Zoom's embedded browser requires cookies with
SameSite=NoneandSecure=true. Without this, sessions break silently. - Always validate the OAuth
stateparameter to prevent CSRF attacks. Generate cryptographically random state, store it, and verify on callback.
Ví dụ yêu cầu
- [Quick Start](examples/quick-start.md) - Hello World Express + SDK app
- [In-Client OAuth](examples/in-client-oauth.md) - PKCE authorization flow
- [Layers Immersive](examples/layers-immersive.md) - Custom video layouts
- [Camera Mode](examples/layers-camera.md) - Virtual camera overlays
- [Collaborate Mode](examples/collaborate-mode.md) - Shared state across participants
- [Guest Mode](examples/guest-mode.md) - Unauthenticated/authenticated/authorized states
Cùng nhóm Vận hành
- Cân nhắc rủi ro trước khi bắt tay làmTrước khi làm sản phẩm, tính năng, MVP hay tự động hóa, chỉ ra rủi ro lớn nhất cần lường trước và chọn bước kiểm chứng nhỏ nhất để thử.
- Tự động thao tác trên trình duyệt webTự động hóa việc trên web: lấy dữ liệu từ trang, điền biểu mẫu, chụp màn hình, trích dữ liệu có cấu trúc. Không dùng để kiểm thử phần mềm.
- Nhúng cuộc họp Zoom vào ứng dụngTài liệu tham khảo Zoom Meeting SDK: tham gia cuộc họp Zoom thật từ ứng dụng của bạn, xác thực, phòng chờ, phòng họp nhỏ, bot họp và các điểm khác nhau giữa các nền tảng.
- Làm chatbot và ứng dụng cho Zoom Team ChatTài liệu tham khảo Zoom Team Chat: gửi tin vào kênh hay tin nhắn riêng, liệt kê kênh, chatbot, thẻ có nút bấm, lệnh gạch chéo và webhook (tín hiệu báo sự kiện).
- Tự dựng giao diện gọi video bằng Zoom Video SDKTài liệu tham khảo Zoom Video SDK cho phiên video tùy biến, khi bạn muốn kiểm soát hoàn toàn trải nghiệm thay vì dùng một cuộc họp Zoom thông thường. Có lưu ý về trình chặn quảng cáo.
- Kiểm tra máy và mạng trước khi vào họpTài liệu tham khảo Zoom Probe SDK: kiểm tra trình duyệt có tương thích không, quyền camera/micro, chẩn đoán âm thanh, video và độ sẵn sàng của mạng trước khi người dùng vào phiên.
Phần giải thích do Skilnexa viết sau khi đọc toàn bộ tài liệu gốc của tác giả và đã đối chiếu lại với nội dung gốc. Chưa phải kết quả thử chạy, nên hãy thử bằng dữ liệu giả trước khi dùng cho việc thật.