RICOH Camera Wireless SDK for iOS

RICOH Camera Wireless SDK enables your app to operate cameras. This page shows how to use SDK packages and a sample app, which comes with the SDK.

Contents

• Requirements
• Quick Start
• Classes
• Versioning Rules

Requirements

Supported Devices

• PENTAX K-1 Mark II
• PENTAX KP
• PENTAX K-70
• PENTAX K-1

Supported Environments

• iOS8 or later

RICOH Camera Wireless SDK requires following OSSs.

OSS	License
Alamofire	MIT License
SwiftWebSocket	MIT License

Quick Start

This section is designed to describe the two approaches to get started with RICOH Camera Wireless SDK. You can run Sample App to understand what the SDK can do and how it works. Also, you can add the SDK to your existing app to enhance it.

Run Sample App

Try out Sample App to understand RICOH Camera Wireless SDK quickly. Sample App has functions such as:

• Connecting to your camera
• Capturing images
• Changing camera settings

You can run the app you build from the source code. (The app was tested in Xcode 9.1.)

Sample App is added required frameworks using Carthage.

Before open Sample App in Xcode for the first time, install Carthage and run carthage update --platform ios.

Integrate SDK into Your App

Follow the instructions below to integrate RICOH Camera Wireless SDK with your existing app. You can also refer to Sample App’s source code for the basic usage.

• Integrate required frameworks (Alamofire, SwiftWebSocket) into your app

• integrate “RICOHCameraWirelessSDK.framework” into your app

  • On your app targets’ “General” settings tab, in the “Embedded Binaries” section, add “RICOHCameraWirelessSDK.framework”

  • On your app targets’ “Build Settings” settings tab, in the “Search Paths” section, add a path of “RICOHCameraWirelessSDK.framework” to “FRAMEWORK_SEARCH_PATHS”

• Explore the quick references of each operation and events to enhance your app.

  • How to connect to cameras
  • How to get camera information
  • How to capture images
  • How to handle images
  • How to obtain live view
  • How to receive camera events
  • Capture Settings
  • Camera Settings
  • Appendix

Classes

RICOHCameraWirelessSDK framework provides functions for camera operations such as shooting and acquiring images. For detailed class reference, visit API Reference.

CameraDevice protocol

CameraDevice protocol manages camera information and operates cameras. See CameraDevice protocol in API Reference for detailed protocol reference.

CameraImage protocol

CameraImage protocol manages image information and image data. See CameraImage protocol in API Reference for detailed protocol reference.

Versioning Rules

RICOH Camera Wireless SDK conforms to Semantic Versioning. See below for versioning rules of the SDK.

Versioning Syntax

RICOH Camera Wireless SDK is versioned in accordance with the following syntax:

{MAJOR}.{MINOR}.{PATCH}

Field Name	Description
MAJOR	Major Version is incremented when some changes that don’t have backwards-compatibility with functionality occur.
MINOR	Minor Version is incremented when some interfaces are changed or added while keep having backwards-compatibility with functionality. In this case, some build errors and other compatible issues may occur in your existing applications.
PATCH	Patch Version is incremented when some security fixes and bug fixes are made while keep having backwards-compatibility with functionality. In this case, existing application build and compatibility with functionality is guaranteed.