.. default-domain:: cpp
.. highlight:: cpp
.. namespace:: krpc::services::SpaceCenter

Communications
==============


.. class:: Comms

   Used to interact with CommNet for a given vessel.
   Obtained by calling :func:`Vessel::comms`.

   .. function:: bool can_communicate()

      Whether the vessel can communicate with KSC.

      :Game Scenes: Flight

   .. function:: bool can_transmit_science()

      Whether the vessel can transmit science data to KSC.

      :Game Scenes: Flight

   .. function:: double signal_strength()

      Signal strength to KSC.

      :Game Scenes: Flight

   .. function:: double signal_delay()

      Signal delay to KSC in seconds.

      :Game Scenes: Flight

   .. function:: double power()

      The combined power of all active antennae on the vessel.

      :Game Scenes: Flight

   .. function:: std::vector<CommLink> control_path()

      The communication path used to control the vessel.

      :Game Scenes: Flight



.. class:: CommLink

   Represents a communication link between two nodes in the network.

   .. function:: CommLinkType type()

      The type of link.

   

   .. function:: double signal_strength()

      Signal strength of the link.

   

   .. function:: CommNode start()

      Start point of the link.

   

   .. function:: CommNode end()

      End point of the link.

   



.. namespace:: krpc::services::SpaceCenter
.. enum-struct:: CommLinkType

   The type of a communication link.
   See :func:`CommLink::type`.


   .. enumerator:: home

      Link is to a base station on Kerbin.


   .. enumerator:: control

      Link is to a control source, for example a manned spacecraft.


   .. enumerator:: relay

      Link is to a relay satellite.



.. namespace:: krpc::services::SpaceCenter
.. struct:: CommNode

   Represents a communication node in the network. For example, a vessel or the KSC.


   .. member:: std::string name

      Name of the communication node.

   .. member:: bool is_home

      Whether the communication node is on Kerbin.

   .. member:: bool is_control_point

      Whether the communication node is a control point, for example a manned vessel.

   .. member:: bool is_vessel

      Whether the communication node is a vessel.

   .. member:: std::optional<Vessel> vessel

      The vessel for this communication node, or null if the node is not a vessel.