# 공동 편집

- Human documentation: [https://docs.univer.ai/ko-KR/guides/pdfs/features/collaboration](https://docs.univer.ai/ko-KR/guides/pdfs/features/collaboration)

- Agent Markdown: [https://docs.univer.ai/ko-KR/guides/pdfs/features/collaboration.md](https://docs.univer.ai/ko-KR/guides/pdfs/features/collaboration.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

- Source: [pdfs/features/collaboration.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/features/collaboration.ko-KR.mdx)

---

[공동 편집 통합](https://docs.univer.ai/ko-KR/server/collaboration/browser-integration.md)에 따라 예제 실행, 앱 연결, 영속성과 권한 검증을 진행하세요. 구현 세부 정보와 Web/Server 예제는 [협업 빠른 시작](https://docs.univer.ai/ko-KR/server/collaboration/quick-start.md)를 참고하세요.

인증된 비즈니스 API에서 Collaboration Service로 Unit을 생성한 뒤 반환된 ID를 브라우저에서 로드하세요. [Quick Start](https://docs.univer.ai/ko-KR/server/collaboration/quick-start.md)에 따라 HTTP, Session Ticket, WebSocket을 설정하고 Database Adapter로 저장하세요. 읽기, JOIN, 수정은 [서버 권한](https://docs.univer.ai/ko-KR/server/collaboration/identity-and-authorization.md)으로 각각 보호해야 합니다.

> [!NOTE]
> 이 API를 사용하기 전에 대상 백엔드가 PDF Unit을 지원하는지 확인하세요. Sheets 협업 예제의 성공이 PDF 지원을 의미하지는 않습니다.

## 협업 PDF 불러오기

서버 API 또는 `importPdfToUnitIdAsync`를 통해 PDF 유닛을 만든 후 협업 퍼사드로 불러오세요.

```ts
const pdf = await univerAPI.getCollaboration().loadPdfAsync(unitId)

if (!pdf) {
  throw new Error(`PDF unit not found: ${unitId}`)
}

console.log(pdf.getId(), pdf.getName())
```

`loadPdfAsync`는 서버 스냅샷을 불러오고 협업 세션을 준비한 다음 `FPdf`를 반환합니다. 유닛을 PDF와 연결할 수 없으면 `null`을 반환합니다.