> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/ops/control/behavior-camera-control.md).

# ふるまい：カメラ制御

## 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](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-c21e61364eba1d1579d500b069c3162b7f7d57fb%2FcameraAnchorHorizontal_left.png?alt=media)

left

![right](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-92bf9713ca4c6d7aac2a33fa4b08615e0f30ff02%2FcameraAnchorHorizontal_right.png?alt=media)

right

![center](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-87c2c743355c8514cc6338ea9976777090d16684%2FcameraAnchorHorizontal_center.png?alt=media)

center

![close\_up](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-96f6a33c78f885b4ae13baae5617a679214cd23a%2FcameraAnchorDistance_close_up.png?alt=media)

close\_up

![loose\_close\_up](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-87c2c743355c8514cc6338ea9976777090d16684%2FcameraAnchorHorizontal_center.png?alt=media)

loose\_close\_up

![tight\_medium\_shot](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-7ae7325fd3004f573204c8ff4b47f81c34b850c9%2FcameraAnchorDistance_tight_medium_shot.png?alt=media)

tight\_medium\_shot

![medium\_shot](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-d479047083077df0643c66e320bc029ba8f43cf3%2FcameraAnchorDistance_medium_shot.png?alt=media)

medium\_shot

![medium\_full\_shot](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-67e0b5757aceda4d95123dbb59544dc0c3e3ecf6%2FcameraAnchorDistance_medium_full_shot.png?alt=media)

medium\_full\_shot

![full\_shot](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-222b7a44bbc3fbf0c6061ed560a3509732732619%2FcameraAnchorDistance_full_shot.png?alt=media)

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 />カメラを右にパン       |

##