Once you have added the Lookback framework to your app, we recommend that you configure your app to use the Participate experience. However, if you'd like to build your own recording/research experience, follow these steps.
1. Set up Lookback
YourAppDelegate.m and paste the 4 numbered lines:
#import <Lookback/Lookback.h> // 1
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
[LookbackRecorder setupWithAppToken:@"YOUR-ORGANIZATION-TOKEN"]; //2
[LookbackRecorder sharedRecorder].shakeToRecord = YES; //3
[LookbackRecorder sharedRecorder].feedbackBubbleVisible = YES; //4
- 1 imports the header
setupWithAppToken, configures Lookback to send videos to your organization. You can find your SDK token under organization settings in the Lookback dashboard.
shakeToRecord, allows your user to get the feedback bubble by shaking their device (this line is optional, if you configure some other way to start recording).
feedbackBubbleVisible, shows the feedback bubble immediately when your app starts, so that testers can easily send you feedback (this line is optional)
- There are many other APIs you can use instead of or together with the feedback bubble. See LookbackRecorder.h for more details.
2. Add Usage Descriptions
If your app is built for iOS 10 or newer, it must provide "usage descriptions" for sensitive data using the new Info.plist keys, otherwise it will crash when attempting to access the data! Lookback uses the camera and microphone, so you'll need to add the
NSMicrophoneUsageDescription keys to your app's Info.plist:
Apps that don't use the camera or microphone can use these descriptions which are specific to Lookback:
NSCameraUsageDescription: Lookback uses the microphone to record you during user research studies.
NSMicrophoneUsageDescription: Lookback uses the camera to record you during user research studies.
Note: If your app does use the camera or microphone, it should have its own descriptions.
Once the descriptions are entered into your Info.plist, they will be presented to the user when your app requests authorization to use the camera or microphone: