pikd_flutter_magnum_experience #

pikd_flutter_magnum_experience opens Magnum's complete, themed PIKD journey: Explore, Mechanics, AR Collect, Leaderboard, and My Collections. It is a facade over the generic pikd_flutter_experience and does not require host apps to assemble AR or collection flows.

Install #

dependencies:
  pikd_flutter_magnum_experience: ^0.8.0-beta.12

Open the experience #

await PikdMagnumExperience.open(
  context,
  configuration: PikdMagnumExperienceConfiguration(
    baseUrl: pikdBaseUrl,
    sdkKey: issuedPikdSdkKey,
    userRef: clientId.toString(),
    locale: PikdLocale.russian,
    contentLanguageRef: 'ru',
    theme: magnumTheme,
  ),
);

The host remains responsible for Maps keys, platform permission declarations, and launching this route from its PIKD entry point. The SDK owns the PIKD screens, campaign navigation, AR session, asset placement, and collection. It also handles Android ARCore installation/update preflight before entering the camera. Magnum does not need to add a separate ARCore check.

If Magnum needs to revise SDK-owned recovery wording later, it may pass localized PikdStrings keys through stringOverrides in its configuration; the default English, Russian, and Kazakh wording is included by the SDK.

Magnum's tenant must expose exactly one active challenge. The facade resolves that challenge from PIKD each time it opens and uses its backend name wherever the campaign title is shown. Changing the active challenge in PIKD therefore does not require a Magnum app release. The facade presents a clear error if the tenant has no active challenge or more than one.

Magnum derives backend content language from locale: Russian sends ru and Kazakh sends kk for campaign, map, and My Collections asset content. The legacy contentLanguageRef constructor argument remains for source compatibility, but it cannot override Magnum's selected UI language. English Magnum content is not currently available and fails clearly before any PIKD request is made.

License #

This package is proprietary software. Use requires a written SDK agreement with ELEOS WORLD LTD. See LICENSE.