# ふるまい：カメラ制御

## Platform2.0

カメラコントロールは、メソッドの`cameraAnchor(position, duration)`を使用してコントロールすることができます。[ホステッドエクスペリエンス メソッド](/dev/hosted-experience/hosted-experience-methods-2.md)ご覧ください。

SpeakAPIを利用するチャットボットや会話AI、SpeakAPIへのリクエストには発話文に`SpeakAPI使用時に発話文に埋め込む場合のタグ`を埋め込めば、フロントエンド側で発話文とカメラ制御のタイミングを調整して動作します。`duration`はフロントエンドのコードに設定します。ただし、発話文を伴わない場合はカメラの制御は出来ません。

| 説明                              | メソッド                                                  | SpeakAPI使用時に発話文に埋め込む場合のタグ                                |
| ------------------------------- | ----------------------------------------------------- | -------------------------------------------------------- |
| カメラを左にパン（デジタルヒューマンは右に移動）        | cameraAnchorHorizontal(`left`, `duration`)            | `<uneeq:custom_event name="camera_left" />`              |
| カメラを右にパン（デジタルヒューマンは左に移動）        | cameraAnchorHorizontal(`right`, `duration`)           | `<uneeq:custom_event name="camera_right" />`             |
| カメラを中央に戻す                       | cameraAnchorHorizontal(`center`, `duration`)          | `<uneeq:custom_event name="camera_center" />`            |
| 顔のアップショット。表情の細部まで見えるような近距離からの撮影 | cameraAnchorDistance(`close_up`, `duration`)          | `<uneeq:custom_event name="camera_close_up" />`          |
| やや引いたアップショット。顔とシャツの袖が見える程度の距離感  | cameraAnchorDistance(`loose_close_up`, `duration`)    | `<uneeq:custom_event name="camera_loose_close_up" />`    |
| 腰から上が映るミディアムショット（標準的）           | cameraAnchorDistance(`tight_medium_shot`, `duration`) | `<uneeq:custom_event name="camera_tight_medium_shot" />` |
| 腰から上が映るミディアムショット                | cameraAnchorDistance(`medium_shot`, `duration`)       | `<uneeq:custom_event name="camera_medium_shot" />`       |
| 膝あたりから上が映るミディアムフルショット           | cameraAnchorDistance(`medium_full_shot`, `duration`)  | `<uneeq:custom_event name="camera_medium_full_shot" />`  |
| 全身が映るフルショット。デジタルヒューマンの全体像を表示します | cameraAnchorDistance(`full_shot`, `duration`)         | `<uneeq:custom_event name="camera_full_shot" />`         |

![left](/files/mWiM3r98AqSLr2TdsR9g)

left

![right](/files/fOPBndlVAceLK6fFbkzg)

right

![center](/files/vN8SVFz4NQiW55AdwpxB)

center

![close\_up](/files/RPl1SKN2y5tTf4eKQ1ed)

close\_up

![loose\_close\_up](/files/TuHFdKeQ1LipsSqFuiEl)

loose\_close\_up

![tight\_medium\_shot](/files/qZis5gIeBjrOuywc6eKk)

tight\_medium\_shot

![medium\_shot](/files/ywLzzhdLjJOtUyiJndrL)

medium\_shot

![medium\_full\_shot](/files/ngh88hfyoOR1uOnrTplH)

medium\_full\_shot

![full\_shot](/files/ApW1j0Z3JxPbZ9c75HGt)

full\_shot

## Platform1.0（終息）

### 概要

カメラコントロールは、インラインタグを付けることでトリガーされます。概要については[こちら](/ops/control/behavior-overview.md)をご覧ください。

カメラコントロールにより、会話デザイナーはダイアログ中にカメラのズームやパンを変更することができます。現在、ズームとパンの量はプリセットされています。別のダイアログノードが別のカメラ設定で表示されるまで保持されます。

ズームとパンは加算的な操作です。つまり、顔へのズームと右へのパンを同時に行うことができます。

## カメラ制御用のタグ

| タグ                           | 説明             | サンプル                                   |
| ---------------------------- | -------------- | -------------------------------------- |
| \<uneeq:camera\_face />      | 顔を表示           | \<uneeq:camera\_face />顔を表示            |
| \<uneeq:camera\_shoulders /> | バストアップを表示      | \<uneeq:camera\_shoulders />バストアップを表示  |
| \<uneeq:camera\_torso />     | 上半身を表示（胴あたりまで） | \<uneeq:camera\_torso />上半身を表示（胴あたりまで） |
| \<uneeq:camera\_fullbody />  | 全身を表示          | \<uneeq:camera\_fullbody />全身を表示       |
| \<uneeq:camera\_left />      | カメラを左にパン       | \<uneeq:camera\_left />カメラを左にパン        |
| \<uneeq:camera\_center />    | カメラを中央に戻す      | \<uneeq:camera\_center />カメラを中央に戻す     |
| \<uneeq:camera\_right />     | カメラを右にパン       | \<uneeq:camera\_right />カメラを右にパン       |

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalhumans.jp/ops/control/behavior-camera-control.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.