Main Page | Modules | Namespace List | Class Hierarchy | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages

RakVoiceInterface Class Reference
[RakVoice Subsystem The RakVoice Subsytem]

Define the user interface of the RakVoice module. More...

#include <RakVoiceInterface.h>

Inheritance diagram for RakVoiceInterface:

RakVoice List of all members.

Public Member Functions

virtual ~RakVoiceInterface ()
virtual void Init (int samplingRate, int bitsPerSample, RakPeerInterface *_peer)=0
virtual void Deinit (void)=0
virtual int GetFrameSize (void) const =0
virtual void Disconnect (PlayerID id)=0
virtual void SetBlockSize (int _blockSize)=0
virtual void EncodeSoundPacket (char *input, PlayerID recipient)=0
virtual void DecodeAndQueueSoundPacket (char *data, int length)=0
virtual bool GetSoundPacket (char *output, PlayerID *sender)=0
virtual int GetNextSoundPacketSize (void)=0
virtual int GetOutputBufferSize (void)=0

Detailed Description

Define the user interface of the RakVoice module.

Users should only use the function provided by this interface while using the RakVoice Subsystem.


Constructor & Destructor Documentation

virtual RakVoiceInterface::~RakVoiceInterface  )  [inline, virtual]
 


Member Function Documentation

virtual void RakVoiceInterface::DecodeAndQueueSoundPacket char *  data,
int  length
[pure virtual]
 

When you get a packet with the type ID_VOICE_PACKET, Pass the data and length to this function. This will decode the data and put it in the internal queue, or simply relay the data if This is the server and the target is not the server

Parameters:
data byte data from the Packet object
length size of data from the Packet object too.

Implemented in RakVoice.

virtual void RakVoiceInterface::Deinit void   )  [pure virtual]
 

Call this before shutting down

Implemented in RakVoice.

virtual void RakVoiceInterface::Disconnect PlayerID  id  )  [pure virtual]
 

Whenever a player disconnects we need to know about it. Otherwise we will be using old values for our encoding. Passing an id that has never been used is ok, it will be ignored.

Parameters:
id discard this player from the RakVoice communication group.

Implemented in RakVoice.

virtual void RakVoiceInterface::EncodeSoundPacket char *  input,
PlayerID  recipient
[pure virtual]
 

When you have raw sound data, pass it to this function. Input must be of size blockSize that you specified in Init This will encode and send in another thread the data as a packet Because of the way encoding works, you cannot broadcast voice data. You must specify a recipient If you want to send to everyone, you have to call this once for each recipient Use UNASSIGNED_PLAYER_ID to send to the server (if you are a client).

Parameters:
input a byte array of block size containing the raw voice data.
recipient the targeted peer or UNASSIGNED_PLAYER_ID if you want to send to the server beeing a client.

Implemented in RakVoice.

virtual int RakVoiceInterface::GetFrameSize void   )  const [pure virtual]
 

Valid to call after a call to Init. Returns the frame size used by the encoder in bytes It is best to send input to EncodeSoundData that matches this frame size

Returns:
the frame size used by the encoder in bytes

Implemented in RakVoice.

virtual int RakVoiceInterface::GetNextSoundPacketSize void   )  [pure virtual]
 

Gives you the size, in bytes, of the next sound packet, or 0 for nothing left

Returns:
the size, in bytes, of the next sound packet, or 0 for nothing left

Implemented in RakVoice.

virtual int RakVoiceInterface::GetOutputBufferSize void   )  [pure virtual]
 

This will tell you the total number of bytes in the output buffer

Returns:
the number of remaining byte in the buffer.

Implemented in RakVoice.

virtual bool RakVoiceInterface::GetSoundPacket char *  output,
PlayerID sender
[pure virtual]
 

This will get the next sound data packet and write it to output Returns false if no packets are waiting. The originator of the packet is written to sender

Parameters:
output The resulting raw voice data
sender The sender of this data
Returns:
false if no packets are waiting

Implemented in RakVoice.

virtual void RakVoiceInterface::Init int  samplingRate,
int  bitsPerSample,
RakPeerInterface _peer
[pure virtual]
 

Call this before using voice packets. Use the server version to send packets through the server, client version to send packets through the client _blockSize is the size of each block that you want to process at a time. Each network packet will have this size before compression. It must be a multiple of frame_size. The best _blockSize is what would be compressed to slightly under your MTU. You can safely assume the compression rate is 50% (actually it's closer to 75%).

Parameters:
samplingRate The rate to use, the higher the better quality and the bigger the size of the data ...
bitsPerSample The number of bits used for one
_peer RakPeer to use for communication it might be a peer, a server or a client.

Implemented in RakVoice.

virtual void RakVoiceInterface::SetBlockSize int  _blockSize  )  [pure virtual]
 

Set the block size that EncodeSoundPacket will read and GetSoundPacket will write. If you don't call this, it will default to GetFrameSize() You should only call this after calling Init. It is reset every call to Init. This must be a multiple of GetFrameSize().

Parameters:
_blockSize The size of a RakVoice packet.

Implemented in RakVoice.


The documentation for this class was generated from the following file:
Generated on Mon May 30 17:45:43 2005 for raknet by  doxygen 1.4.2