SSkilnexa
SkillVận hànhHợp với: Lập trình viên webMức: Kỹ thuật

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út theo dõi đang được chuẩn bị.
Link tải đang được chuẩn bị.

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

  1. Tổng quan SDK
  2. Bắt đầu nhanh
  3. Cài bằng NPM hoặc CDN
  4. Xung đột biến toàn cục
  5. Chế độ xem thử trên trình duyệt
  6. Danh sách URL cho phép (bắt buộc)
  7. Phạm vi quyền OAuth (bắt buộc)
  8. 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/drawWebView may fail if called too early. Implement retry with exponential backoff.
  • Zoom's embedded browser requires cookies with SameSite=None and Secure=true. Without this, sessions break silently.
  • Always validate the OAuth state parameter 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

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.