Mirrors/overte
3
0
Fork 0
mirror of https://github.com/overte-org/overte.git synced 2025-08-08 10:57:25 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Fill in Agent API JSDoc

Browse source
This commit is contained in:
David Rowe 2019-02-21 11:19:29 +13:00
parent f58a5db0b0
commit 01119a5b5d
2 changed files with 23 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
assignment-client/src/AgentScriptingInterface.h
View file

@ -18,16 +18,25 @@
#include "Agent.h" #include "Agent.h"
/**jsdoc /**jsdoc
* The <code>Agent</code> API enables an assignment client to emulate an avatar. In particular, setting <code>isAvatar =
* true</code> connects the assignment client to the avatar and audio mixers and enables the {@link Avatar} API to be used.
*
* @namespace Agent * @namespace Agent
* *
* @hifi-assignment-client * @hifi-assignment-client
* *
* @property {boolean} isAvatar * @property {boolean} isAvatar - <code>true</code> if the assignment client script is emulating an avatar, otherwise
* @property {boolean} isPlayingAvatarSound <em>Read-only.</em> * <code>false</code>.
* @property {boolean} isListeningToAudioStream * @property {boolean} isPlayingAvatarSound - <code>true</code> if the script has a sound to play, otherwise <code>false</code>.
* @property {boolean} isNoiseGateEnabled * Sounds are played when <code>isAvatar</code> is <code>true</code>, from the position and with the orientation of the
* @property {number} lastReceivedAudioLoudness <em>Read-only.</em> * scripted avatar's head.<em>Read-only.</em>
* @property {Uuid} sessionUUID <em>Read-only.</em> * @property {boolean} isListeningToAudioStream - <code>true</code> if the agent is "listening" to the audio stream from the
* domain, otherwise <code>false</code>.
* @property {boolean} isNoiseGateEnabled - <code>true</code> if the noise gate is enabled, otherwise <code>false</code>. When
* enabled, the input audio stream is blocked (fully attenuated) if it falls below an adaptive threshold.
* @property {number} lastReceivedAudioLoudness - The current loudness of the audio input, nominal range <code>0.0</code> (no
* sound) &ndash; <code>1.0</code> (the onset of clipping). <em>Read-only.</em>
* @property {Uuid} sessionUUID - The unique ID associated with the agent's current session in the domain. <em>Read-only.</em>
*/ */
class AgentScriptingInterface : public QObject { class AgentScriptingInterface : public QObject {
Q_OBJECT Q_OBJECT
@ -54,20 +63,24 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* Set whether or not the script should emulate an avatar.
* @function Agent.setIsAvatar * @function Agent.setIsAvatar
* @param {boolean} isAvatar * @param {boolean} isAvatar - <code>true</code> if the script should act as if an avatar, otherwise <code>false</code>.
*/ */
void setIsAvatar(bool isAvatar) const { _agent->setIsAvatar(isAvatar); } void setIsAvatar(bool isAvatar) const { _agent->setIsAvatar(isAvatar); }
/**jsdoc /**jsdoc
* Check whether or not the script is emulating an avatar.
* @function Agent.isAvatar * @function Agent.isAvatar
* @returns {boolean} * @returns {boolean} <code>true</code> if the script is acting as if an avatar, otherwise <code>false</code>.
*/ */
bool isAvatar() const { return _agent->isAvatar(); } bool isAvatar() const { return _agent->isAvatar(); }
/**jsdoc /**jsdoc
* Play a sound from the position and with the orientation of the emulated avatar's head. No sound is played unless
* <code>isAvatar == true</code>.
* @function Agent.playAvatarSound * @function Agent.playAvatarSound
* @param {object} avatarSound * @param {SoundObject} avatarSound - The sound to play.
*/ */
void playAvatarSound(SharedSoundPointer avatarSound) const { _agent->playAvatarSound(avatarSound); } void playAvatarSound(SharedSoundPointer avatarSound) const { _agent->playAvatarSound(avatarSound); }

2
assignment-client/src/avatars/ScriptableAvatar.h
View file

@ -20,7 +20,7 @@
/**jsdoc /**jsdoc
* The <code>Avatar</code> API is used to manipulate scriptable avatars on the domain. This API is a subset of the * The <code>Avatar</code> API is used to manipulate scriptable avatars on the domain. This API is a subset of the
* {@link MyAvatar} API. * {@link MyAvatar} API. To enable this API, set {@link Agent|Agent.isAvatatr} to <code>true</code>.
* *
* @namespace Avatar * @namespace Avatar
* *