GameKit.ShowChallengeComposeDialog
----------------------------------

Shows challenge compose dialog.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [GameKit](component_GameKit.md) | [8.5](newinversion85.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "GameKit.ShowChallengeComposeDialog"; scoreRef or AchievementRef; Message; playerIdentifiers { ; FileName; ScriptName } ) 

**MBS**( **"GameKit.ShowChallengeComposeDialog";** /\* Shows challenge compose dialog. \*/  
**$scoreRef or AchievementRef**; /\* The score or achievement identiifer. \*/   
**$Message**; /\* The message text. \*/   
**$playerIdentifiers**; /\* The list of player identifiers. \*/   
**$FileName**; /\* Optional; The database file name where the script is located.e.g. "test.fmp12" \*/   
**$ScriptName**) /\* Optional; The script name.e.g. "MyScript" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| scoreRef or AchievementRef | The score or achievement identiifer. |  |  |
| Message | The message text. |  |  |
| playerIdentifiers | The list of player identifiers. |  |  |
| FileName | The database file name where the script is located. | "test.fmp12" | Optional |
| ScriptName | The script name. | "MyScript" | Optional |

### Result

Returns OK or error.

### Description

Shows challenge compose dialog.  
Provides a challenge compose view controller with pre-selected player identifiers and a pre-formatted, player-editable message.  
Once dialog finishes, the given script is triggered and passed either didIssueChallenge or cancel as parameter.  
This function is free to use.

Created 5th November 2018 , last changed 8th November 2018

  
[GameKit.SetPlayerDidChangeScriptTrigger](GameKitSetPlayerDidChangeScriptTrigger.md) - [GetSystemUIMode](GetSystemUIMode.md)

[HTML Version](GameKitShowChallengeComposeDialog.shtml)