# Usage

Once you have [enabled the required features](/v2/game-services/setup.md#properties) that you are going to use in Media Services, you can start using the API by importing the namespace.

```csharp
Using VoxelBusters.EssentialKit;
```

Once after importing the namespace, all features within Media Services can be accessed through **MediaServices** class.

Before accessing any gallery features, you need to check if your app have access to gallery.

#### Get read status

```
GalleryAccessStatus readAccessStatus   = MediaServices.GetGalleryAccessStatus(GalleryAccessMode.Read);
```

#### Get read/write status

```
GalleryAccessStatus readWriteAccessStatus   = MediaServices.GetGalleryAccessStatus(GalleryAccessMode.ReadWrite);
```

Once you know the [status](https://voxel-busters-interactive.github.io/cross-platform-essential-kit/api/VoxelBusters.EssentialKit.GalleryAccessStatus.html?q=GalleryAccessStatus) and you don't have the permission, you can request the access. This request will popup a dialog to let user allow the permission.

#### Request  gallery access for Read mode

```csharp
MediaServices.RequestGalleryAccess(GalleryAccessMode.Read, callback: (result, error) =>
{
    Debug.Log("Request for gallery access finished.");
    Debug.Log("Gallery access status: " + result.AccessStatus);
});
```

#### Request  gallery access for ReadWrite mode

```csharp
MediaServices.RequestGalleryAccess(GalleryAccessMode.ReadWrite, callback: (result, error) =>
{
    Debug.Log("Request for gallery access finished.");
    Debug.Log("Gallery access status: " + result.AccessStatus);
});
```

#### Read camera access

```csharp
MediaServices.RequestCameraAccess(callback: (result, error) =>
{
    Debug.Log("Request for camera access finished.");
    Debug.Log("Camera access status: " + result.AccessStatus);
});
```

#### Get images from Gallery or Camera

For getting the images from gallery, you need read access(**GalleryAccessmode.Read)** to gallery. Once you have the access, you can call **SelectImageFromGallery** which can return the texture data in the callback.

```csharp
MediaServices.SelectImageFromGallery(canEdit: true, (textureData, error) =>
{
    if (error == null)
    {
        Debug.Log("Select image from gallery finished successfully.");
        //textureData.GetTexture() // This returns the texture
    }
    else
    {
        Debug.Log("Select image from gallery failed with error. Error: " + error);
    }
});
```

{% hint style="warning" %}
**canEdit** flag will be ignored on Android where as on iOS it opens up an option to edit the image allowing it to crop.
{% endhint %}

For capturing an image from device camera, you need camera permission which can be gained with **RequestCameraAccess** method. Once you have the permission, you can call CaptureImageFromCamera method.

```csharp
MediaServices.CaptureImageFromCamera(true, (textureData, error) =>
{
    if (error == null)
    {
        Debug.Log("Capture image using camera finished successfully.");
    }
    else
    {
        Debug.Log("Capture image using camera failed with error. Error: " + error);
    }
});
```

{% hint style="success" %}
For fetching the images with permission, you can use utility methods **SelectImageFromGalleryWithUserPermision** and **CaptureImageFromCameraWithUserPermision**.
{% endhint %}

### Save image to gallery

You need to have read-write access for saving images to gallery. For requesting access you need to call  RequestGalleryAccess with **GalleryAccessmode.Read** mode. Once you have the permission, you need to call SaveImageToGallery by passing the image texture.

```csharp
Texture2D texture; // Set the texture before calling
MediaServices.SaveImageToGallery(texture, (result, error) =>
{
    if (error == null)
    {
        Debug.Log("Save image to gallery finished successfully.");
    }
    else
    {
        Debug.Log("Save image to gallery failed with error. Error: " + error);
    }
});
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://assetstore.essentialkit.voxelbusters.com/v2/media-services/usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.