P PLAIS 영상회의 연동

DEVELOPER GUIDE

회의실 하나를 여러 사이트에서.

최대 12명 영상회의를 링크 또는 iframe으로 연결할 수 있습니다. API 키는 운영자가 발급하며 각 사이트의 서버에서만 사용합니다.

OpenAPI 명세 Node.js 서버 SDK Express 연동 예제

1. 회의실 생성 — 서버에서 호출

POST https://talk.plais.kr/meet/api/v1/rooms
Authorization: Bearer YOUR_SERVER_API_KEY
Content-Type: application/json

{ "title": "정기회의", "expected": 12 }

응답의 inviteUrl은 참가자에게 전달하고 hostUrl은 주최자에게만 전달합니다. ownerToken도 주최자 관리 권한이므로 공개하면 안 됩니다. 초대 링크를 가진 사람은 참가할 수 있으며 회의실은 최대 2시간 유지됩니다. 아무도 입장하지 않으면 5분 뒤, 마지막 참석자가 나가고 재접속하지 않으면 약 1분 뒤 자동 종료됩니다.

2. 버튼으로 열기

<a href="서버에서 받은 inviteUrl" target="_blank" rel="noopener">
  영상회의 참가
</a>

3. 페이지 안에 삽입

<div id="meeting"></div>
<script src="https://talk.plais.kr/meet/embed.js"></script>
<script>
  const meeting = PlaisMeet.mount('#meeting', {
    inviteUrl: '서버에서 받은 inviteUrl',
    height: '800px'
  });
  // 화면을 제거하면 카메라·마이크 연결도 종료됩니다.
  // meeting.destroy();
</script>

삽입할 사이트는 HTTPS여야 하며 운영자가 허용 도메인에 등록해야 합니다. 상위 페이지의 Permissions-Policy가 카메라·마이크 위임을 차단하지 않아야 합니다. 모바일은 새 탭으로 여는 방식도 함께 제공하는 것이 좋습니다.

서버 SDK로 연결

const { PlaisMeetClient } = require("./plais-meet.cjs");
const meeting = new PlaisMeetClient({ apiKey: process.env.PLAIS_MEET_API_KEY });
const room = await meeting.createRoom({ title: "정기회의", expected: 12 });
// room.hostUrl: 인증된 주최자에게만 전달
// room.inviteUrl: 참가자에게 전달
await meeting.getRoom(room.room.id);
// await meeting.endRoom(room.room.id);

Node.js 22 이상에서 사용합니다. 연동 사이트의 실제 관리자 인증 미들웨어 뒤에 생성 API를 연결하세요. 먼저 사이트 HTTPS 도메인을 운영자에게 등록하고 사이트별 API 키를 발급받아야 페이지 삽입을 사용할 수 있습니다. 회의 생성 한도는 전체 서버의 동시 수용 한도를 함께 적용합니다.

4. 조회·종료

GET    /meet/api/v1/rooms/{roomId}
DELETE /meet/api/v1/rooms/{roomId}
Authorization: Bearer YOUR_SERVER_API_KEY

조회·종료는 동일한 연동 계정으로 만든 회의실에만 적용됩니다. 주최자는 브라우저에서도 전체 음소거, 선택한 참가자의 음소거 해제, 내보내기와 회의 종료를 할 수 있습니다.

영상·음성 정책

참가자는 기본 음소거이며 손든 참가자의 이름이나 영상을 주최자가 누르면 마이크가 켜집니다. 발언 요청하지 않은 참가자는 허용 후 직접 마이크를 켭니다. 예상 참석 인원과 실제 인원 중 큰 값을 기준으로 화질을 조절하며, 최대 12개 영상과 전체 참석자의 음성을 수신합니다. 주최자 권한 회수는 연결 서버와 수신 화면에 적용합니다. 에코 제거·소음 억제를 요청하고, 누르고 말하기를 사용할 수 있습니다.

화면 공유는 지원하는 브라우저에서 사용할 수 있습니다. 스마트폰은 회의 참가·카메라·음성·공유 화면 보기를 지원하며, 화면 송출 기능은 브라우저에 따라 제공되지 않을 수 있습니다.

영상회의로 돌아가기 →