Description

The Cloudinary Image Uploader Interface Asset enables you to upload an image to Cloudinary from a running Intuiface experience and receive a URL.

We have two versions of this Interface Asset: one supported by Player 8 and above, and the other by Player Classic.

To use these Interface Assets, you'll need a few credentials from your Cloudinary account. The Cloud Name identifies your account and is required for all uploads. An Upload Preset defines how images are uploaded, such as folder location and upload permissions. You will also need an API Key and API Secret if you are using the Player Classic version.

• For Player 8 and above, follow these prerequisites.

• For Player Classic, follow these prerequisites.

Want to use these Interface Assets within your experience? View this article about how to Reuse an Interface Asset from any Experience.

Cloudinary Image Uploader (Player 8 and above)

The Player 8 version of the Cloudinary Image Uploader Interface Asset contains two triggers, each with one parameter, and one action with three parameters. 

Prerequisites

1. Create a Cloudinary account at Cloudinary.

2. In your Cloudinary dashboard:

   1. Create an upload preset (under Settings > Upload > Upload Presets > Add Upload Preset).

   2. The upload preset must be specified for unsigned uploads (set "Signing Mode" to Unsigned)

3. Note your Cloud name from the Account Details section.

4. These two values - the Upload preset and Cloud name - must be specified in the action parameters of this version of the Interface Asset.

You can download this Interface Asset, which is used in our "Photo Booth - Share via QR Code" Sample to store captured images in the cloud, made available via a QR code.

Triggers

• Error message received
  Raised when the Cloudinary API has returned an error.
  • Error Message: The value of the error message.
• Image uploaded
  Raised when the image has been successfully uploaded
  • Image URL: This is the URL returned by Cloudinary after an image is uploaded.

To display the image which has been uploaded to Cloudinary, you will need to use the Change Image action on an Image Asset and bind the source value to the Image URL parameter of the Image uploaded trigger. (Please take a look at the screenshot for reference).

Actions

• Upload Image: Uploads an image to Cloudinary
  • Upload preset: This is the upload preset specified within your Cloudinary account.
  • Cloud name: This is the cloud name specified within your Cloudinary account.
  • Image path: This is the file path to the image that will be uploaded to Cloudinary

Cloudinary Image Uploader (Player Classic)

The Player Classic version of the Cloudinary Image Uploader Interface Asset contains four properties, two triggers, each with one parameter, and one action with one parameter. 

Prerequisites

1. Create a Cloudinary account at Cloudinary.

2. In your Cloudinary dashboard:

   1. Note your Cloud name from the Account Details section.

   2. The upload preset must be specified for unsigned uploads (set "Signing Mode" to Unsigned)

3. Generate an API Key and API Secret (under Settings > Account Details > API Keys).

4. These three values - Cloud name, API Key, and API Secret - must be specified in the properties within this version of the Interface Asset.

You can download this Interface Asset, which is being used in our Post an image to Facebook sample to store captured images in the cloud, made available via a QR code. You can also access the source code here: GitHub. 

Properties

• Cloud name: This is the cloud name specified within your Cloudinary account.
• API Key: This is the API key provided by your Cloudinary account for authentication.
• API Secret: This is the secret key associated with your Cloudinary API key, used for secure access.
• Last uploaded image URL (read only): This is the URL of the most recently uploaded image to your Cloudinary.

Triggers

• Image upload failed
  Raised when the Cloudinary API has returned an error.
  • Error Message: The value of the error message.
• Image uploaded
  Raised when the image has been successfully uploaded
  • Image URL: This is the URL returned by Cloudinary after an image is uploaded.

Actions

• Upload Image: Uploads an image to Cloudinary
  • Image URI: This is the file path to the image that will be uploaded to Cloudinary