RICOH Camera Wireless SDK for Android

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

Supported Devices

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

Supported Environments

  • Java Development Kit (JDK) 1.7 or later

RICOH Camera Wireless SDK requires following OSSs.

OSS License
Jackson Apache License 2.0
OkHttp Apache License 2.0
SLF4J Android MIT License
SnakeYAML Apache License 2.0

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 Android Studio 2.2.2.)

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.

  • Add ricoh-camera-wireless-sdk-x.x.x.jar file to libs folder of your module.

  • Modifiy build.gradle of your module as follows.

android {
    packagingOptions {
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/NOTICE'
    }
}

dependencies {
  compile fileTree(include: ['*.jar'], dir: 'libs')
  compile 'com.fasterxml.jackson.core:jackson-core:2.4.4'
  compile 'com.fasterxml.jackson.core:jackson-annotations:2.4.4'
  compile 'com.fasterxml.jackson.core:jackson-databind:2.4.4'
  compile 'com.squareup.okhttp3:okhttp:3.4.2'
  compile 'com.squareup.okhttp3:okhttp-ws:3.4.2'
  compile 'org.slf4j:slf4j-android:1.6.1-RC1'
  compile 'org.yaml:snakeyaml:1.18:android'
}
  • Add following setting to AndroidManifest.xml to allow applications to open network sockets.
<uses-permission android:name="android.permission.INTERNET"/>

Classes

com.ricoh.camera.sdk.wireless.api package provides functions for camera operations such as shooting and acquiring images. For detailed class reference, visit JavaDoc.

CameraDevice Interface

CameraDevice Interface manages camera information and operates cameras. See CameraDevice Interface in JavaDoc for detailed interface reference.

CameraImage Interface

CameraImage Interface manages image information and image data. See CameraImage Interface in JavaDoc for detailed interface 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.