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 tolibs
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"/>
-
Explore the quick references of each operation and events to enhance your app.
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. |