StirfireStudios/aws-sdk-unity

Official repository for the AWS Mobile SDK for Unity. For more information, see our web site: http://aws.amazon.com/mobile/sdk/

AWS Mobile SDK for Unity

The AWS Mobile SDK for Unity contains a set of .NET classes that enables games written with Unity to utilize AWS services.

Requirements

• The AWS Mobile SDK for Unity is compatible with Unity 4.0 and onward, and supports both Free and Pro versions.

Resources

• Code Sample - Repository of example projects using the SDK.
• AWS Mobile Forum – Ask questions, get help, and give feedback
• Developer Guide - For in-depth getting started and usage information
• API Reference - For operations, parameters, responses, and examples
• AWS Mobile Developer Blog - For updates and guidance on using the AWS SDK for Android
• Release Notes - To see the latest features, bug fixes, and changes in the SDK
• Issues - Report issues and submit pull requests
• @awsformobile - Follow us on Twitter

Supported AWS Services

The AWS SDK for Unity supports the following AWS services:

• Amazon Cognito
• Amazon DynamoDB
• Amazon Mobile Analytics
• Amazon SNS
• Amazon S3

SDK Fundametals

There are only a few fundamentals that are helpful to know when developing against the AWS SDK for Unity

• Logging in SDK is enabled by default. To disable logging for the sdk open Assets\AWSSDK\src\Core\Resources\awsconfig.xml, and delete the logging section. Alternatively you can also change the LogTo Attribute to "None".To enable logging again add the following section to the awsconfig.xml

        <logging
            logTo="UnityLogger"
            logResponses="Always"
            logMetrics="true"
            logMetricsFormat="JSON" />

• Use Unity patch 4.6.3P3 or later, for compiling applications to iOS 64 Bit Devices.
• You must have AWSPrefab on the first scene where you instantiate AWS services.
• Never embed credentrials in an application. It is trivially easy to decompile applications and steal embedded credentials. Always use temporarily vended credentials from services such as Amazon Cognito Identity.
• Calls are always asynchronous unlesss explicitly stated. In some cases there may be internal Sync API's, but it is highly discouraged to use them as it may block the game thread.THe Asynchronous Responses are always returned on main thread unless specified in AsyncOptions parameter.

Note: For a complete summary of improvements since the Developer Preview, please refer to our blog post here.