SetDiscordRichPresenceButton: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
{{Important Note|To use this function, you must set up own application [[setDiscordApplicationID]]}}
{{Important Note|To use this function, you must set up your own application [[setDiscordApplicationID]]}}
{{New feature/item|3.0162|1.6.0|22269|
The function sets a custom button through which we can access the website on Discord.
The function sets a custom button through which we can access the website on Discord.
}}


==Syntax==  
==Syntax==  
Line 11: Line 13:


===Required arguments===
===Required arguments===
*'''index''': a int index of the button (possible 1 and 2)
*'''index''': a int representing the index of the button (possible values: 1 or 2)
*'''text''': a string with title name
*'''text''': a string containing the title of the button
*'''url''': a string with url name (works only with '''https://''' or '''mtasa://''')
*'''url''': a string containing the button URL (only works with '''https://''' or '''mtasa://''')


===Returns===
===Returns===
Returns ''true'' if function succeeds, ''false'' if the client has disabled synchronisation.
Returns ''true'' if function succeeds, ''false'' otherwise.


==Example==
==Example==
This example prints out if the application was successfully set up and set custom buttons.
This example creates two custom buttons in our Discord Rich Presence application.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local app_key = "YOUR_APPLICATION_KEY"
local app_key = "YOUR_APPLICATION_KEY"

Revision as of 01:01, 11 October 2023

[[{{{image}}}|link=|]] Important Note: To use this function, you must set up your own application setDiscordApplicationID
ADDED/UPDATED IN VERSION 1.6.0 r22269:

The function sets a custom button through which we can access the website on Discord.

Syntax

bool setDiscordRichPresenceButton(int index, string text, string url)

OOP Syntax Help! I don't understand this!

Method: DiscordRPC:setButton(...)


Required arguments

  • index: a int representing the index of the button (possible values: 1 or 2)
  • text: a string containing the title of the button
  • url: a string containing the button URL (only works with https:// or mtasa://)

Returns

Returns true if function succeeds, false otherwise.

Example

This example creates two custom buttons in our Discord Rich Presence application.

local app_key = "YOUR_APPLICATION_KEY"
if setDiscordApplicationID(app_key) then 
    setDiscordRichPresenceButton(1, "Connect to server", "mtasa://youraddressip")
    setDiscordRichPresenceButton(2, "MTA Homepage", "https:/mtasa.com")
end 

See Also

ADDED/UPDATED IN VERSION 1.6.0 r22270:
ADDED/UPDATED IN VERSION 1.6.0 r22276:
ADDED/UPDATED IN VERSION 1.6.0 r22342: