1.3.1 • Published 10 months ago

ai.natml.natshare v1.3.1

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
10 months ago

NatShare

NatShare is a lightweight, easy-to-use native sharing API for Unity Engine. NatShare supports sharing text, images (using a Texture2D) and media files (using a string path). Currently, you can save media to the camera roll and open the native sharing UI.

Setup Instructions

Add the following items to your Unity project's Packages/manifest.json:

{
  "scopedRegistries": [
    {
      "name": "NatML",
      "url": "https://registry.npmjs.com",
      "scopes": ["ai.natml"]
    }
  ],
  "dependencies": {
    "ai.natml.natshare": "1.3.1"
  }
}

Native Sharing

To share media, you can use the SharePayload:

// Say we want to share an image
Texture2D image = ...;
// Create a share payload
using var payload = new SharePayload();
// Add the image to the payload
payload.AddImage(image);
// Share!
await payload.Share();

Saving to the Camera Roll

You can save images or media files to the camera roll with the SavePayload:

// Say we want to save an image to the camera roll
Texture2D image = ...;
// Create a save payload
using var payload = new SavePayload();
// Add different items
payload.AddImage(image);
payload.AddMedia("/path/to/some/media/animated.gif");
// Save to the camera roll!
await payload.Save();

Platform Notes

iOS

After building an Xcode project from Unity, add the following keys to the Info.plist file with a good description:

  • NSPhotoLibraryUsageDescription
  • NSPhotoLibraryAddUsageDescription

Android

When building an Android project with Proguard stripping, make sure to add a keep rule for NatShare:

-keep class ai.natml.** { *; }

Requirements

  • Unity 2021.2+

Supported Platforms

  • Android API level 24+
  • iOS 14+
  • WebGL:
    • Chrome 91+
    • Firefox 90+
    • Safari 13+

Resources

Thank you very much!

1.3.1

10 months ago

1.3.0

2 years ago