SetRadioChannel: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(12 intermediate revisions by 8 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
This function sets the currently active radio channel.
This function sets the heard radio channel, even while not in a vehicle.
{{Note|This function sometimes doesn't work when setting the radio channel to another different from the current one due to unknown reasons. If you experience this issue, simply add setRadioChannel(0) at the beginning of the script, outside any function.}}


==Syntax==  
==Syntax==  
Line 16: Line 17:
Returns ''true'' if channel was set successfully, ''false'' otherwise.
Returns ''true'' if channel was set successfully, ''false'' otherwise.


==Example==  
==Example==
This example adds a command ''setradio'' which can be used to change the current radio station by ID.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler ( "setradio",
addCommandHandler ( "setradio",
     function ( command, stationID )
     function ( command, stationID )
         setRadioChannel ( tonumber( stationID ) )
         local result = setRadioChannel ( tonumber( stationID ) )
         outputChatBox ( "You set your radio station to: " .. stationID )
         if result then -- if we had a valid ID
            outputChatBox ( "Changed your radio station to " .. getRadioChannelName ( tonumber ( stationID ) ) .. "!" )
        else
            outputChatBox ( "Invalid radio station ID, valid ones are 0-12." )
        end
     end
     end
)
)
</syntaxhighlight>
</syntaxhighlight>
</section>
== Issues ==
{{Issues|
{{Issue|8908|setRadioChannel sometimes doesn't work when outside a vehicle}}
}}


==See Also==
==See Also==


{{Client_audio_functions}}
{{Client_audio_functions}}
[[hu:setRadioChannel]]
[[AR:setRadioChannel]]
[[RO:setRadioChannel]]

Revision as of 20:22, 8 July 2019

This function sets the heard radio channel, even while not in a vehicle.

[[{{{image}}}|link=|]] Note: This function sometimes doesn't work when setting the radio channel to another different from the current one due to unknown reasons. If you experience this issue, simply add setRadioChannel(0) at the beginning of the script, outside any function.

Syntax

bool setRadioChannel ( int ID )             

Required Arguments

  • ID: The ID of the radio station you want to play.
  • 0: Radio Off
  • 1: Playback FM
  • 2: K-Rose
  • 3: K-DST
  • 4: Bounce FM
  • 5: SF-UR
  • 6: Radio Los Santos
  • 7: Radio X
  • 8: CSR 103.9
  • 9: K-Jah West
  • 10: Master Sounds 98.3
  • 11: WCTR
  • 12: User Track Player

Returns

Returns true if channel was set successfully, false otherwise.

Example

This example adds a command setradio which can be used to change the current radio station by ID.

Click to collapse [-]
Client
addCommandHandler ( "setradio",
    function ( command, stationID )
        local result = setRadioChannel ( tonumber( stationID ) )
        if result then -- if we had a valid ID
            outputChatBox ( "Changed your radio station to " .. getRadioChannelName ( tonumber ( stationID ) ) .. "!" )
        else
            outputChatBox ( "Invalid radio station ID, valid ones are 0-12." )
        end
    end
)

Issues

Issue ID Description
#8908 setRadioChannel sometimes doesn't work when outside a vehicle

See Also