Camera-Extension/docs/index.md

title, brief

title	brief
Defold camera extension API documentation	This manual covers how to use the camera on macOS, iOS and Android in Defold.

Defold camera extension API documentation

This extension provides a unified, simple to use interface to capture images using the camera on macOS, iOS and Android.

Installation

To use this library in your Defold project, add the following URL to your game.project dependencies:

https://github.com/defold/extension-camera/archive/master.zip

We recommend using a link to a zip file of a specific release.

Configuration

The extension can be configured by adding the following fields to game.project:

[adinfo]
tracking_usage_description = We would like to show you relevant ads.
register_for_attribution = 1

tracking_usage_description

Before requesting advertising info and status on iOS 14 the application must request user authorization to access app-related data for tracking the user or the device. This is done automatically when adinfo.get() is called. The string set in adinfo.tracking_usage_description will be shown to the user.

Apple documentation: https://developer.apple.com/documentation/apptrackingtransparency?language=objc

register_for_attribution

The extension can automatically register the application for ad network attribution using SkAdNetwork and the registerAppForAdNetworkAttribution() function. Enable this functionality by setting adinfo.register_for_attribution to 1 in game.project.

Apple documentation: https://developer.apple.com/documentation/storekit/skadnetwork

Example

function init(self)
    adinfo.get(function(self, info)
      print(info.ad_ident, info.ad_tracking_enabled)
    end)
end

FAQ

How do I reset macOS camera permission?

To test macOS camera permission popup multiple times you can reset the permission from the terminal:

tccutil reset Camera

Source code

The source code is available on GitHub

API reference