Get the framework

The Driver Achievement UI SDK is available on Cocoapods master repo.

To access the framework in the repository, add the following lines to your Podfile:

target 'my-target' do
 pod 'DriveKitDriverAchievementUI'
end

Then, run pod install.

On a Github repository, you also have a demo app and source code of Driver Achievement UI that you can use as an example.

Initialize

An initialization phase is required to use the feature included in the Driver Achievement UI SDK. In the application's AppDelegate file, import DriveKitDriverAchievementUI.

import DriveKitDriverAchievementUI

‌Then, to initialize the Driver Achievement UI SDK in your app, you must call the initialization method in didFinishLaunchingWithOptions method of your AppDelegate.

import DriveKitCore
import DriveKitCommonUI
import DriveKitDriverAchievementUI
​
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
   DriveKit.shared.initialize()
   DriveKitUI.shared.initialize()
   DriveKitDriverAchievementUI.shared.initialize()
   ...   
}

Override colors and texts

To override colors and texts in the Driver Achievement UI SDK, see Common UI configuration.

Select Streak themes

You can choose which streak theme you want to display in which order by calling the following method:

DriveKitDriverAchievementUI.shared.configureStreakThemes(streakThemes: [StreakDataType])

Accepted values:

• .phoneDistraction

• .safety

• .acceleration

• .brake

• .adherence

• .speedLimits

Default value:

[.phoneDistraction, .safety, .acceleration, .brake, .adherence]

Select Badges categories

You can choose which badge category you want to display in which order by calling the following method:

DriverAchievementUI.shared.configureBadgeCategories(badgeCategories: [DKBadgeCatergory])

Accepted values:

• .generic

• .ecodriving

• .safety

• .phoneDistraction

Default value:

[.generic, .ecodriving, .safety, .phoneDistraction]

Select ranking themes

By calling the following method, you can choose which ranking types you want to display:

DriveKitDriverAchievementUI.shared.configureRankingTypes([DKRankingType])

Accepted values:

• .ecodriving

• .safety

• .phoneDistraction

• .speeding

Default value:

[.safety, .ecoDriving, .distraction]

Set ranking selectors

This method allows you to change the displayed periods of ranking:

DriveKitDriverAchievementUI.shared.configureRankingSelector(DKRankingSelectorType)

Accepted values:

• .none

• .period

Default value:.period(rankingPeriods: [.weekly, .monthly, .allTime])

Configure ranking depth

This method allows you to choose the ranking depth you want to display:

DriveKitDriverAchievementUI.shared.configureRankingDepth(Int)

Default value: 5

Accepted values: from 5 to 20

​

​