# クイックスタート

- Human documentation: [https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/quickstart](https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/quickstart)

- Agent Markdown: [https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/quickstart.md](https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/quickstart.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.1.0`

- Source: [pdfs/getting-started/quickstart.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/getting-started/quickstart.ja-JP.mdx)

---

Univer PDFs をインストールする前に、PDF 統合の基礎となる 4 つの概念を確認します。

* プラグイン
* スナップショットとデータモデル
* コマンド
* Facade API

## 基本概念

### プラグイン

Univer PDFs はプラグインを組み合わせて構成します。`UniverPdfsPlugin` は `UNIVER_PDF` ユニットモデルと永続的な PDF コマンドを登録します。`UniverPdfsUIPlugin` はブラウザー用ビューアーと、既定で編集コントロールを追加します。印刷、交換、コラボレーションのパッケージは、必要な機能だけを追加してください。

これらのプラグインは、Univer 共通のコア、レンダリング、デザイン、UI サービス上で動作します。これらは PDF アプリケーションの技術的依存関係であり、ほかの Univer 製品を使用した経験は必要ありません。

### スナップショットとデータモデル

1 つの PDF ユニットは [`IPdfUnitData` スナップショット](https://docs.univer.ai/ja-JP/guides/pdfs/model/pdf-data.md)として保存されます。`document` はインポート済みまたは空のソース基準で、確定した編集はその基準を直接書き換えずに `editState` へ保存されます。

現在の完全なスナップショットは `pdf.save()` で取得します。`pdf.getDocument()` はソース基準を返すため、ユーザーの編集を永続化するときは `save()` を使用してください。

### コマンド

実行中の変更はコマンドを通して行います。これにより、検証、ビューの更新、編集履歴、エクスポート意図が同じ変更フローに入ります。PDF の Facade メソッドはパラメーターを準備してコマンドを実行します。

> [!WARNING: 注意]
> 実行中の PDF ユニットのスナップショットやソース文書を直接変更しないでください。PDF の Facade メソッドまたは登録済みコマンドを使用してください。

### Facade API

コアの Facade エントリの後で `@univerjs-pro/pdfs/facade` をインポートすると、`FUniver` に PDF API が追加されます。このエントリは `createPdf()`、`getActivePdf()`、`getPdf()` などを提供します。

完全な設定と例は [PDF Facade API の使用](https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/facade.md)を参照してください。

次に、[インストールと基本使用](https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/installation.md)へ進みます。