@@ -14,7 +14,7 @@ In the Character Plugin folder, simply navigate to **Blueprints/SocialGroups** a
At first, depending on the size of the group, place the desired amount of VHs into the scene. Make sure that each VH has the ``VHSocialGroups`` and ``VHGazing`` component added. Then place the Social Group blueprint into the scene. In the details panel of the Social Group actor, make sure that ``Spawn as Group`` is false, then add the VHs to the ``Agents in Group`` array. Under dialogue, make sure that ``Start Dialogue`` is false, as this requires additional setup. That's all, if you press play, the agents should arrange themselves in a circular formation around the Social Group actor and follow the behavior described in the [Social Group Behavior](#social-group-behavior) section.
### Adding Dialogue
First of all, make sure that all the VHs that are in the group, have the ``VHSpeech``, ``VHAudiofileSourceComponent`` and ``VHFaceAnimation``(LiveLink, OpenFace or OculusLipsync see [LipSync](Components/LipSync)) components. In the details panel of the Social Group actor, enable ``Start Dialogue`` (or call the Start Dialogue function at some point during the game). Create entries in the ``Dialogues`` array, in the form of Paths to the LipSync and Audio files. These files will be used by the ``VHAudiofileSourceComponent`` and ``VHFaceAnimation``. For more information, see [LipSync](Components/LipSync) and [Virtual Acoustic Plugin](https://devhub.vr.rwth-aachen.de/VR-Group/unreal-development/plugins/unreal-va-plugin/-/wikis/Home). Additionally, specify the gender of the agent, that this dialogue should be assigned to. Add as many dialogues as you want. Finally, specify the number of agents, the dialogues should be distributed between and decide, if the dialogue should be looped, once it has finished. E.g. the ``Dialogues`` array contains five entries and ``Number of Agents in Conversation`` is set to three. Then three agents will be chosen at random, matching the gender if possible. The first three dialogues will then be distributed to the 3 agents, the fourth dialogue will be assigned to the first agent and the fifth one to the second agent.
First of all, make sure that all the VHs that are in the group, have the ``VHSpeech``, ``VHAudiofileSourceComponent`` and ``VHFaceAnimation``(LiveLink, OpenFace or OculusLipsync see [LipSync](Components/LipSync)) components. In the details panel of the Social Group actor, enable ``Start Dialogue``. Create entries in the ``Dialogues`` array, in the form of Paths to the LipSync and Audio files. These files will be used by the ``VHAudiofileSourceComponent`` and ``VHFaceAnimation``. For more information, see [LipSync](Components/LipSync) and [Virtual Acoustic Plugin](https://devhub.vr.rwth-aachen.de/VR-Group/unreal-development/plugins/unreal-va-plugin/-/wikis/Home). Additionally, specify the gender of the agent, that this dialogue should be assigned to. Add as many dialogues as you want. Finally, specify the number of agents, the dialogues should be distributed between and decide, if the dialogue should be looped, once it has finished. E.g. the ``Dialogues`` array contains five entries and ``Number of Agents in Conversation`` is set to three. Then three agents will be chosen at random, matching the gender if possible. The first three dialogues will then be distributed to the 3 agents, the fourth dialogue will be assigned to the first agent and the fifth one to the second agent.
### Spawn in Group formation
Instead of placing VHs into the scene and adding them to the Social Group, it is also possible to activate ``Spawn as Group``. You can then specify the amount of agents you want to spawn and also provide the types of VHs that should be spawned in the ``VHTypes`` array. Ideally, you want the amount of entries in the``VHTypes`` array to match the group size, otherwise the same agent will get spawned twice.
