Application.CommitSuicide (int mode) ??

I can't find any document to explain this function.

Code (csharp):

1. Application.CommitSuicide (int mode)

What does this function do?

 

I am surprised you found that code since I thought it was hidden.

You are supposed to implement that code if Unity is formally banned by Apple.

However, I am unsure what it does as I have not tried it myself. If you like, you may try it and I will see if I hear back from you after. : )

Thanks.

 

What the heck! I just tried it and unity actually accepted it. I wonder what it does?

 

It sends out a press release to all the gaming sites telling them how horrible your game is.

 

I wonder how many values we can choose of the parameter "mode".

 

Ha ha ha...

It is exposed there when I use "GoTo the Definition" function to explore Application class.

 

This code must be creeping into my games then :?

 

I was feeling suicidal, it causes a fatal error, with intent...

 

mmmm... I can't imagine what's the purpose for this function?

 

It's for internal use only; developers aren't supposed to use it. It's for the engine only.

For anyone that didn't get what it does yet - Application.CommitSuicide(1) simply says an 'intentional error occured' and causes Windows to think it crashed (the Report Bug window also pops up in Unity). After you close it out, you can just simply restart Unity like it didn't happen (Hopefully you saved beforehand!).

 

Here is a real example of what you can do with it:
If you have a license check implemented within your game and find the user has a pirated version of it, you should save that to a PlayerPrefs and call Application.CommiteSuicide() to instantly crash the game. Since you saved it, you should check the value of the PlayerPrefs and crash the game every time the pirate tries to open it.

 

For the curious: it's used by our automated tests. 0 - will simulate crash, 1 - will simulate a fatal error that Unity has caught, 2 - will call abort(). And don't ever call it with 666!

 

Man I was hoping for a fun hidden gem there but 666 did nothing.

 

So why exactly is it hidden and not shown up when typing it out?

 

It's meant only for our internal usage, hence why it's not documented and marked as obsolete.

 

I know its a late comment be I found this method very useful in testing crash reporting tools