Changes

All relevant changes to our SDK between versions will be documented on this page. The versioning follows a <major>.<minor>.<patch>[-<label>] format, where the major version is increased for backwards-incompatible changes, the minor versioning when we introduce new features, and the patch version when we fix bugs.

The label is used to indicate release candidates that might become a new release if there are no critical bugs found after they've been available for some time. We do not recommend publishing a release candidate to your users, but they can be useful if you want to prepare for an upcoming feature.

Generally old features will remain availabe but be tagged as deprecated before they are replaced with a newer feature, but this depends a bit on how widely the feature is used and how much hassle the upgrade is.

If you encounter any bugs or problems, or have any feature requests for an upcoming version of the SDK, you can file an issue in our GitHub repo, or reach out to us on mail.


Changelog

5.0.5

Released 2024-01-31. Download for iOS Unity Android

Fixed

Changed

5.0.4

Released 2020-09-18. Download for iOS Unity Android

Fixed

5.0.3

Released 2020-04-25. Download for iOS Unity Android

Fixed

5.0.2

Released 2020-02-15. Download for iOS Unity Android

Fixed

5.0.1

Released 2020-01-25. Download for iOS Unity Android

Fixed

5.0.0

Released 2019-11-16. Download for iOS Unity Android

Lots of changes under the hood in this one to improve performance, which should enable higher framerates with less CPU usage on most devices.

Removed

Changed

Fixed

4.3.2

Released 2019-08-26. Download for iOS Unity Android

Fixed

4.3.1

Released 2019-07-16. Download for iOS Unity Android

Fixed

Added

4.3.0

Released 2019-06-15. Download for iOS Unity Android

The SDK can now also be used to capture and share still images in addition to GIFs! Either use the new shareScreenshot helper which will both capture and share a screenshot, or set maxFrames = 1 on a recording and share it later. The latter approach enables you to show a preview of the screenshot before sharing it.

Fixed

Added

Changed

Deprecated

4.2.2

Released 2019-05-30. Download for iOS Unity Android

Fixed

4.2.1

Released 2019-05-30. Download for iOS Unity Android

This release was yanked.

4.2.0

Released 2019-04-04. Download for iOS Unity Android

We've added the ability to fully customize the links shared from the SDK! Not only can you now use your own domain for the links, like mygame.example.com, you can also set the path, and it can be shared between games. This enables you to have example.com/games/mygame for one title, and exampe.com/games/newgame for another. This is what we call the base url, to which the share url (set with ShareConfig.url(Url)) will be appended. The absolute url shared will thus be on the form https://<base-url><share-url>?_m=<referral-code>.

The default base url remains mgcl.co/<app-identifier>. Custom base urls is a premium feature which is currently in beta, contact us if you want to help test this in your game and we'll help you get it set up. Note that while the feature is still in beta there's no documentation of it outside the SDK reference docs.

Added

Fixed

Deprecated

Removed

4.1.2

Released 2019-03-19. Download for iOS Unity Android

Fixed

4.1.1

Released 2019-03-14. Download for iOS Unity Android

Fixed

4.1.0

Released 2019-03-10. Download for iOS Unity Android

We've overhauled the event callback APIs to make it easier and safer to use, with less dictionaries with magic keys. Now every platform has dedicated classes for each event which clearly documents available properties, and a new initializer to set the callbacks.

Changed

Added

Fixed

Deprecated

Removed

4.0.6

Released 2019-02-09. Download for iOS Unity Android

Fixed

Added

4.0.5

Released 2019-01-31. Download for iOS Unity Android

Fixed

4.0.3

Released 2019-01-30. Download for iOS Unity Android

Fixed

4.0.2

Released 2019-01-25. Download for iOS Unity Android

Fixed

4.0.1

Released 2019-01-14. Download for iOS Unity Android

Fixed

4.0.0

Released 2018-12-31. Download for iOS Unity Android

Changed

Added

Removed

Fixed

Deprecated

3.3.7

Released 2018-11-19. Download for iOS Unity Android

Changed

Added

Fixed

3.3.6

Released 2018-10-24. Download for iOS Unity Android

Fixed

3.3.5

Released 2018-09-26. Download for iOS Unity Android

Fixed

Deprecated

3.3.4

Released 2018-09-14. Download for iOS Unity Android

Fixed

3.3.3

Released 2018-09-10. Download for iOS Unity Android

Fixed

3.3.2

Released 2018-08-29. Download for iOS Unity Android

Fixed

3.3.1

Released 2018-08-21. Download for iOS Unity Android

Fixed

3.3.0

Released 2018-08-20. Download for iOS Unity Android

The automatic frame rate adjustment changes we introduced in 3.2 caused devices that couldn't capture at the intended frame rate (usually 10fps) to play back the content at the frame rate they actually managed, like 8. This caused recordings to be quite choppy, whereas earlier this had been camouflaged by them always being played back at the intended rate, like 10fps, and thus getting a slight speedup. To try to keep recordings smooth in most cases we're now defaulting to speeding them up a little bit to get back the old behavior.

Changed

Added

Fixed

Removed

Deprecated

3.2.1

Released 2018-07-17. Download for iOS Unity Android

Fixed

3.2.0

Released 2018-06-26. Download for iOS Unity Android

Changed

Deprecated

Fixed

Removed

3.1.9

Released 2018-05-22. Download for iOS Unity Android

Fixed

3.1.8

Released 2018-05-02. Download for iOS Unity Android

Changed

Fixed

3.1.7

Released 2018-04-18. Download for iOS Unity Android

Fixed

Added

3.1.6

Released 2018-04-11. Download for iOS Unity Android

Fixed

3.1.5

Released 2018-04-03. Download for iOS Unity Android

Fixed

3.1.4

Released 2018-03-16. Download for iOS Unity Android

Fixed

3.1.3

Released 2018-03-03. Download for iOS Unity Android

Fixed

3.1.2

Released 2018-02-28. Download for iOS Unity Android

Fixed

3.1.1

Released 2018-02-27. Download for iOS Unity Android

Fixed

3.1.0

Released 2018-02-16. Download for iOS Unity Android

Changed

Fixed

Added

Deprecated

3.0.2

Released 2018-02-01. Download for iOS Unity Android

Fixed

3.0.1

Released 2018-01-17. Download for iOS Unity Android

Fixed

3.0.0

Released 2018-01-10. Download for iOS Unity Android

Mostly cleanup and bug fixes, but bumping the major version since iOS has gotten some backwards-incompatible changes. All the major iOS methods (startRecording, preview, share) now take configuration blocks instead of dictionaries, ensuring much less magic keys and more type safety.

Changed

Deprecated

Added

Fixed

Removed

2.6.5

Released 2017-12-16. Download for iOS Unity Android

Fixed

2.6.4

Released 2017-12-13. Download for iOS Unity Android

Fixed

2.6.3

Released 2017-12-06. Download for iOS Unity Android

Fixed

2.6.2

Released 2017-12-01. Download for iOS Unity Android

Fixed

2.6.1

Released 2017-11-16. Download for iOS Unity Android

Deprecated

Fixed

2.6.0

Released 2017-11-03. Download for iOS Unity Android

Very exciting release this time, introducing both highlight recording and capture without extra blits or renders on Unity.

Added

Changed

Fixed

2.5.1

Released 2017-09-12. Download for iOS Unity Android

Fixed

Added

2.5.0

Released 2017-08-23. Download for iOS Unity Android

Changed

Fixed

Added

Removed

Deprecated

2.4.5

Released 2017-08-14. Download for iOS Unity Android

Fixed

2.4.4

Released 2017-08-10. Download for iOS Unity Android

Fixed

2.4.3

Released 2017-08-09. Download for iOS Unity Android

Fixed

Removed

Added

2.4.2

Released 2017-07-14. Download for iOS Unity Android

Fixed

2.4.1

Released 2017-07-11. Download for iOS Unity Android

Fixed

2.4.0

Released 2017-06-07. Download for iOS Unity Android

It's here! The latest and greatest, out of RC and ready for the world, the first finished release that supports compiling to Android from Unity!

Android is still not at full feature parity with iOS, the following is still unimplemented:

These features will appear gradually as we get around to implementing them, if you've got a crush on any of them, let us know and we can prioritize that.

Changed

Fixed

Added

2.4.0-rc3

Released 2017-05-23. Download for iOS Unity Android

2.4.0 getting closer! A couple of issues found so far in the RC that we're aware of:

Android:

2.4.0.

Unity Android:

Changed

Fixed

2.4.0-rc2

Released 2017-05-12. Download for iOS Unity Android

Changed

Fixed

2.4.0-rc1

Released 2017-05-10. Download for iOS Unity Android

First release that supports Android for Unity! Not entirely at feature parity with iOS yet, we'll be gradually fixing the discrepancies in upcoming releases. The following doesn't work on Android yet:

Any and all feedback you have from trying it out is greatly appreciated.

Fixed

2.3.0

Released 2017-04-26. Download for iOS Unity Android

First Android release! Only supports native Android for now, Unity will hopefully come Real Soon Now(tm). Mostly on feature parity with iOS, except the following:

While we hope you don't encounter any stacktraces or crashes that originate from us, if you do please send them our way, we can only fix what we're aware of.

Head over to https://docs.megacool.co/quickstart/android to get started!

Removed

2.2.4

Released 2017-04-14. Download for iOS Unity

Fixed

2.2.3

Released 2017-03-29. Download for iOS Unity

Fixed

2.2.2

Released 2017-03-27. Download for iOS Unity

Fixed

2.2.1

Released 2017-03-23. Download for iOS Unity

Fixed

2.2.0

Released 2017-02-24. Download for iOS Unity

Added

Fixed

2.1.2

Released 2016-12-16. Download for iOS Unity

Added

Fixed

2.1.1

Released 2016-11-16. Download for iOS Unity

Fixed

2.1.0

Released 2016-11-14. Download for iOS Unity

Changed

Added

Deprecated

2.0.7

Released 2016-11-03. Download for iOS Unity

Fixed

2.0.6

Released 2016-10-10. Download for iOS Unity

Fixed

2.0.5

Released 2016-10-07. Download for iOS Unity

Fixed

2.0.4

Released 2016-10-05. Download for iOS Unity

Fixed

2.0.3

Released 2016-10-04. Download for iOS Unity

Fixed

2.0.2

Released 2016-09-30. Download for iOS Unity

Fixed

2.0.1

Released 2016-09-29. Download for iOS Unity

Fixed

2.0.0

Released 2016-08-31. Download for iOS Unity

Changed

Removed

Added

Fixed

1.2.5

Released 2016-04-22. Download for iOS Unity

Fixed

1.2.4

Released 2016-04-20. Download for iOS Unity

Added

Changed

Fixed

1.2.3

Released 2016-04-18. Download for iOS Unity

Added

Fixed

1.2.2

Released 2016-03-31. Download for iOS Unity

Fixed

1.2.1

Released 2016-03-29. Download for iOS Unity

Fixed

1.2.0

Released 2016-03-25. Download for iOS Unity

Added

Fixed

Deprecated

1.1 - 2016-02-18

Added

Fixed

Deprecated

1.0.5

Released 2016-01-13. Download for iOS Unity

Fixed

Changed

1.0.4

Released 2015-12-08. Download for iOS Unity

First release in a production app!

Changed

Fixed

1.0.3

Released 2015-12-07. Download for iOS Unity

1.0.2 was never released to the public.

Added

Changed

1.0.1

Released 2015-12-06. Download for iOS Unity

Fixed

Added

1.0.0

Released 2015-12-01. Download for iOS Unity

First release!