FGCom 3.0: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
No edit summary
m (Reverted edits by F-EFEL (talk) to last revision by F-JJTH)
Line 1: Line 1:
{{note|Le contenu de cette page s'applique uniquement pour Flightgear 2.99+ et FGCom 2.99+}}
{{note|The documentation available in this page is ONLY relevant for Flightgear 2.99+ and FGCom 2.99+}}


{{Infobox Software
{{Infobox Software
Line 10: Line 10:
}}
}}


= Qu'est ce que FGCom ? =
= What is FGCom ? =
FGCom est un moyen de communication vocale, vous permettant de communiquer avec les autres pilotes et contrôleurs aériens pendant votre vol, et dont le but est de reproduire des conditions de radio-communication les plus réalistes possibles.
FGCom is a voice communication feature. That way you can communicate with other pilots and airspace controllers during your flight.


The main idea is to reproduce the real aviation communication, in other words this feature is designed to make radio communication as real as possible during your flights.


FGCom se présente sous deux formes:
FGCom is available by two ways:
* Application Integrée dans FlightGear (FGCom builtin)
* Integrated into FlightGear (FGCom builtin): this is certainly the better solution because easier to use
* Application externe autonome (FGCom standalone)
* External software (FGCom standalone): you should use this one only if you plan to use FGCom in a special case




'''IMPORTANT:'''  
'''IMPORTANT:'''  
* FGCom intégré est destiné à FlightGear 3.0 ou supérieur, c'est certainement la solution la plus commode
* FGCom builtin is available for FlightGear 3.0 or higher and is certainly the solution you are looking for because really easy to use.
* FGCom autonome (standalone) sera seulement pour ceux qui veulent une installation complexe, ou qui n'utilisent pas  FlightGear 3.0 ou supérieur.  
* FGCom standalone is only for those who want a complex setup or don't use FlightGear 3.0 or higher.  
* Si vous n'utilisez pas FlightGear 3.0 ou supérieur reportez-vous à [[FGCom_3.0#FGCom_standalone|FGCom standalone section]] et suivez les instructions "Si FlightGear n'est pas installé" .
* If you are not using FlightGear 3.0 or higher you have to read the [[FGCom_3.0#FGCom_standalone|FGCom standalone section]] and follow "If FlightGear is not installed" instructions.


= FGCom intégré =
= FGCom builtin =
=== Installation ===
=== Installation ===
Bonne nouvelle: FGcom est inclus dans le software FlightGear, aucune d'installation supplémentaire à faire, vous avez FlightGear, vous pouvez immédiatement utiliser FGcom.
The good news here is that FlightGear has now an FGCom client built in the software. That means there is no additional installation step. If you have installed FlightGear you can immediately use FGCom.


=== Comment démarrer FGCom intégré ? ===
=== How to start FGCom builtin ? ===
# Lancer FlightGear
# Start FlightGear
# Ouvrir la fenêtre de dialogue "Multiplayer > FGCom Settings"
# Open the dialog located in "Multiplayer > FGCom Settings"
# Cocher la case  "Enable"  
# Check the "Enable" checkbox
# Fermer la fenêtre
# Close the dialog


Si vous préférez, lancez la commande
You can also use the command line if you prefer:
  --enable-fgcom (equivalent de--prop:/sim/fgcom/enabled=true )
  --enable-fgcom (equivalent to --prop:/sim/fgcom/enabled=true )
  --disable-fgcom (equivalent de --prop:/sim/fgcom/enabled=false )
  --disable-fgcom (equivalent to --prop:/sim/fgcom/enabled=false )


FGCom sera automatiquement programmé pour vos sessions futures, jusqu'à ce que vous décochiez la case "enable"
FGCom will be automatically enabled for your future sessions until you uncheck the "Enable" checkbox.


=== Comment tester votre installation ? ===
=== How to test your setup ? ===
Pour vérifier que micro et haut-parleurs sont correctement connectés et opérationnels, effectuez les étapes suivantes:
In order to check that your microphone and speakers are correctly connected and functional you can test it with the following steps:


# Lancez FlightGear (si ce n'est pas déja fait)
# Start FlightGear (if not yet done of course)
# Ouvrez la boîte de dialogue dans "Multiplayer > FGCom Settings"
# Open the dialog located in "Multiplayer > FGCom Settings"
# Cochez la case  "Enable" checkbox (si ce n'est pas déja fait)
# Check the "Enable" checkbox (if not yet done of course)
# Cochez la case  "Test"  
# Check the "Test" checkbox
Vous devez alors entendre votre voix en écho, avec un bref délai. Si ce n'est pas le cas, votre micro ou vos HP sont mal installés
At this moment you should hear your own voice with a delay. If you can't hear your own voice it means your microphone or your speakers are wrongly set.
# Décochez la case "Test"  
# Unckeck the "Test" checkbox
# Fermez la fenêtre dialog
# Close the dialog




=== Comment utiliser FGCom intégré ? ===
=== How to use FGCom builtin ? ===
Une fois FGCom démarré [[FGCom_3.0#How_to_start_FGCom_builtin_.3F|How to start FGCom builtin]] , vous pouvez utiliser votre radio comme dans la réalité
Once you started FGCom from the [[FGCom_3.0#How_to_start_FGCom_builtin_.3F|How to start FGCom builtin]] procedure, you can simply use your radio stack like it done in real life.


Quand vous voulez parler, vous appuyez sur la touche  {{Key press|Space}}"Espace". Quand {{Key press|Shift}} est appuyé, vous n'entendez pas les autres pilotes
When you want to talk you have to press {{Key press|Space}}. When the {{Key press|Space}} is pressed you can't hear other pilots.


Vous pouvez basculer entre COM1 et COM2 en appuyant {{Key press|Shift}} + {{Key press|Space}}
You can switch between COM1 and COM2 by pressing {{Key press|Shift}} + {{Key press|Space}}




=== Détails de dialog ===
=== Dialog details ===
[[File:FGCom dialog.png|thumb|FGCom dialog]]
[[File:FGCom dialog.png|thumb|FGCom dialog]]
La fenêtre située dans "Multiplayer > FGCom Settings" montre:
The dialog located in "Multiplayer > FGCom Settings" provide some features described here:


* Enable : vous pouvez cocher/décocher pour activer/désactiver le mode FGCom  
* Enable : you can check/uncheck this for enable/disable FGCom feature
* Display messages : affiche  le message en cours seulement pour debug  
* Display messages : display FGCom transaction message for debug only
* Speaker volume : règle le volume des HP
* Speaker volume : set speaker volume
* Registration > Enabled : activer/désactiver l'enregistrement sur le serveur (Vous devez désactiver FGCom, activer registration et mettre votre nom d'utilisateur/pwd quand on recoche FGCom)
* Registration > Enabled : enable/disable registration on server (you must disable FGCom, enable registration and set your username/pwd then re-enable FGCom)
* Registration > Username : nom d'utilisateur à mettre pour l'enregistrement sur le serveur
* Registration > Username : username to be used for registration on server
* Registration > Password : mot de passe à mettre pour l'enregistrement sur le serveur
* Registration > Password : password to be used for registration on server
* Server > Test : cocher/décocher ici pour tester le serveur (Echo-Box)
* Server > Test : check/uncheck this for testing server communication (Echo-Box)
* Server > List : Selectionne le serveur à connecter ( effet immédiat)  
* Server > List : Select the server to be connected (immediat effect)  




Line 188: Line 189:


You have to follow "If FlightGear is not installed" instructions until you upgrade your FlightGear installation.
You have to follow "If FlightGear is not installed" instructions until you upgrade your FlightGear installation.
[[fr:FGCom 3.0]]

Revision as of 11:31, 15 November 2013

Note  The documentation available in this page is ONLY relevant for Flightgear 2.99+ and FGCom 2.99+
FGCom 3.0
FGCom 3.0 logo
Developed by Holger Wirtz
Martin Spott
Csaba Halasz
Clément de l'Hamaide
Development status Active
License GNU GPL v2
Website

What is FGCom ?

FGCom is a voice communication feature. That way you can communicate with other pilots and airspace controllers during your flight.

The main idea is to reproduce the real aviation communication, in other words this feature is designed to make radio communication as real as possible during your flights.

FGCom is available by two ways:

  • Integrated into FlightGear (FGCom builtin): this is certainly the better solution because easier to use
  • External software (FGCom standalone): you should use this one only if you plan to use FGCom in a special case


IMPORTANT:

  • FGCom builtin is available for FlightGear 3.0 or higher and is certainly the solution you are looking for because really easy to use.
  • FGCom standalone is only for those who want a complex setup or don't use FlightGear 3.0 or higher.
  • If you are not using FlightGear 3.0 or higher you have to read the FGCom standalone section and follow "If FlightGear is not installed" instructions.

FGCom builtin

Installation

The good news here is that FlightGear has now an FGCom client built in the software. That means there is no additional installation step. If you have installed FlightGear you can immediately use FGCom.

How to start FGCom builtin ?

  1. Start FlightGear
  2. Open the dialog located in "Multiplayer > FGCom Settings"
  3. Check the "Enable" checkbox
  4. Close the dialog

You can also use the command line if you prefer: 

--enable-fgcom (equivalent to --prop:/sim/fgcom/enabled=true )
--disable-fgcom (equivalent to --prop:/sim/fgcom/enabled=false )

FGCom will be automatically enabled for your future sessions until you uncheck the "Enable" checkbox.

How to test your setup ?

In order to check that your microphone and speakers are correctly connected and functional you can test it with the following steps:

  1. Start FlightGear (if not yet done of course)
  2. Open the dialog located in "Multiplayer > FGCom Settings"
  3. Check the "Enable" checkbox (if not yet done of course)
  4. Check the "Test" checkbox

At this moment you should hear your own voice with a delay. If you can't hear your own voice it means your microphone or your speakers are wrongly set.

  1. Unckeck the "Test" checkbox
  2. Close the dialog


How to use FGCom builtin ?

Once you started FGCom from the How to start FGCom builtin procedure, you can simply use your radio stack like it done in real life.

When you want to talk you have to press Space. When the Space is pressed you can't hear other pilots.

You can switch between COM1 and COM2 by pressing ⇧ Shift + Space


Dialog details

FGCom dialog

The dialog located in "Multiplayer > FGCom Settings" provide some features described here:

  • Enable : you can check/uncheck this for enable/disable FGCom feature
  • Display messages : display FGCom transaction message for debug only
  • Speaker volume : set speaker volume
  • Registration > Enabled : enable/disable registration on server (you must disable FGCom, enable registration and set your username/pwd then re-enable FGCom)
  • Registration > Username : username to be used for registration on server
  • Registration > Password : password to be used for registration on server
  • Server > Test : check/uncheck this for testing server communication (Echo-Box)
  • Server > List : Select the server to be connected (immediat effect)


FGCom standalone

Installation

If FlightGear is installed:

The good news here is that if you have FlightGear installed on your computer you already have FGCom standalone !


If FlightGear is not installed:

If you haven't installed FlightGear on the computer where you want to use FGCom standalone you can simply download FGCom standalone with the following steps:

  1. Download FGCom standalone: Windows 32 bits | Windows 64 bits | Linux 32 bits | Linux 64 bits (take care to select the correct version for your computer !)
  2. Unzip the downloaded file
  3. That's all ! Of course you can place the "FGCom" folder where you want on your computer

On Linux, you have to setup the permission as "executable" for the files "run_fgcom.sh" and "test_fgcom.sh"

How to start FGCom standalone ?

If FlightGear is installed:

On Windows you have to execute FGCom located in your Start menu > FlightGear > Tools > FGCom

On Linux you have to execute FGCom located in your Application menu > Games > FGCom


If FlightGear is not installed:

On Windows, in your unzipped "FGCom" folder, you have to execute (double clic on it) the file "run_fgcom.bat".

On Linux, in your unzipped "FGCom" folder, you have to execute (double clic on it) the file "run_fgcom.sh".


In both case

Now a terminal has been opened and you should be able to see the following lines: 

Successfully parsed commandline options
Loaded file [../share/flightgear/special_frequencies.txt].
Reading airports [../share/flightgear/positions.txt]
loaded 46927 entries
Initializing IAX client as guest:xxxxxxxxxxx@fgcom.flightgear.org

How to test your setup ?

If FlightGear is installed:

On Windows you have to execute FGCom located in your Start menu > FlightGear > Tools > FGCom-testing

On Linux you have to execute FGCom located in your Application menu > Games > FGCom-testing


If FlightGear is not installed:

On Windows, in your unzipped "FGCom" folder, you have to execute (double clic on it) the file "test_fgcom.bat".

On Linux, in your unzipped "FGCom" folder, you have to execute (double clic on it) the file "test_fgcom.sh".


In both case

Now you should be able to hear your own voice with a delay and see the following lines: 

Successfully parsed commandline options
Loaded file [../share/flightgear/special_frequencies.txt].
Reading airports [../share/flightgear/positions.txt]
loaded 46927 entries
Initializing IAX client as guest:xxxxxxxxxxx@fgcom.flightgear.org
Originating an audio only call
Failed video codec negotiation.
Call 0 accepted
Echo Box - For testing FGCOM
Call 0 answered

In order to stop FGCom standalone you have to press Control + c

How to use FGCom standalone ?

Once you started FGCom from the How to start FGCom standalone procedure, you have to start FlightGear with the following option: 

--generic=socket,out,1,127.0.0.1,16661,udp,fgcom

Now you have to leave FGCom standalone running and simply use FlightGear without taking care of FGCom standalone.

When you want to talk you have to press Space. When the Space is pressed you can't hear other pilots.

You can switch between COM1 and COM2 by pressing ⇧ Shift + Space

During your FlightGear session you should be able to see some lines in the FGCom standalone, it's totally normal, they are here to inform you about the state of FGCom standalone (when you are listening, talking, changing frequency, changing COM1/2...)

In order to stop FGCom standalone you have to press Control + c

Options details

Starting FGCom standalone with "-h" argument will show you all available options.

IMPORTANT: Keep in mind that FGCom standalone works fine for a standard operating system without options at all ! Use them only if you know exactly what they do.

FAQ

How to add the --generic option for FGCom standalone ?

On the last page of the FlightGear Launcher, press "Advanced" then select "Input/Output" item. Press "New" and set the fields as:

  • Protocol  : generic
  • Medium  : socket
  • Direction : out
  • Hz  : 5
  • Hostname  : 127.0.0.1
  • Port  : 16661
  • Select UDP
  • Generic  : fgcom

I want to use FGCom builtin but I haven't any item "Multiplayer > FGCom Settings" in FlightGear

Because you are not using FlightGear 3.0 or higher. FGCom builtin is only available for FlightGear 3.0 or higher. You have to use FGCom standalone until you upgrade your FlightGear installation.

I want to use FGCom standalone but I haven't any FGCom item in "Start menu > FlightGear > Tools"

Because you are not using FlightGear 3.0 or higher. FGCom standalone is automatically installed only for FlightGear 3.0 or higher.

You have to follow "If FlightGear is not installed" instructions until you upgrade your FlightGear installation.

Retrieved from "https://wiki.flightgear.org/w/index.php?title=FGCom_3.0&oldid=64548"