theta-api1-android-sdk/README.txt at master · ricohapi/theta-api1-android-sdk · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
==================================================
 README for "RICOH THETA SDK for Android"

 Version :0.3.1
==================================================

This file is an explanation document for RICOH THETA SDK for Android.
ricoh-theta4j and r-exif4j are libraries for creating apps for Android.
ricoh-theta-sample-for-android is a sample app created using the libraries mentioned above.

----------------------------------------

* Contents of this Document

    * Terms of Service
    * Files included in the archive
    * Required environment for development
    * How to Use
    * Latest information
    * Troubleshooting
    * Trademarks
    * Update History

----------------------------------------

* Terms of Service

    Terms of service are included in the LICENSE.txt (LICENSE_ja.txt) file.
    It is assumed that you have agreed to these terms of service when you start using RICOH THETA SDK.

----------------------------------------

* Files included in the archive

    README.txt: This file (English)
    README_ja.txt: This file (Japanese)
    LICENSE.txt: Terms of service file (English)
    LICENSE_ja.txt: Terms of service file (Japanese)
    ricoh-theta-sample-for-android
    ┣ libs: Sample project library
    ┣ res: Sample project resource file
    ┣ src: Sample application source
    ┗ doc: Sample application Javadoc
    lib
    ┣ bin
    ┃  ┣ ricoh-theta4j.0.3.1.jar: Library about operations of RICOH THETA
    ┃  ┗ r-exif4j.0.3.1.jar: Library that enables acquisition of EXIF information from spherical images shot using RICOH THETA
    ┣ src
    ┃  ┣ ricoh-theta4j: The source of ricoh-theta4j
    ┃  ┗ r-exif4j: The source of r-exif4j
    ┗ doc
       ┣ ricoh-theta4j: Javadoc for ricoh-theta4j
       ┗ r-exif4j: Javadoc for r-exif4j

----------------------------------------

* Required environment for development

    [About RICOH THETA]
      Dedicated RICOH THETA library that fulfills the following conditions.

      * Hardware
          RICOH THETA (2013 launch Model)
          RICOH THETA (Model:RICOH THETA m15)
      * Firmware
          Version 1.21 or higher
          (Method for checking and updating the firmware:  https://theta360.com/en/support/manual/content/pc/pc_05.html)


    [About the Development Environment for Sample Application]
      Operation of the sample application has been verified under the following conditions.

      * Verified operating environment
          Nexus 5
      * Development/Build Environment
          Eclipse Mars
          Android Studio 1.4
          Android SDK (API Level 21)

----------------------------------------

* How to Use

    [Operating the Sample Application]
        1. Import ricoh-theta-sample-for-android.0.3.1 as a project into Eclipse or Android Studio, and build it in the Android device.
        2. Connect the RICOH THETA to the Android device using Wi-Fi.
            (Usage instructions, connecting the camera to a smartphone: https://theta360.com/en/support/manual/content/prepare/prepare_06.html)
        3. Viewer section within the sample program is created using OpenGL ES2.0.
           Use a device that is compatible with the operation.
        4. The sample application can be operated

    [Using your own app with RICOH THETA SDK]
        1. Pass the classpaths of ricoh-theta4j.0.3.1.jar and r-exif4j.0.3.1.jar through your own app.
        2. Mount based on the sample application and information described below.

    [More detailed information]
        See the contents of the provided library source and Javadoc, as well as documents on the Internet for further information.

        https://developers.theta360.com/en/docs/

----------------------------------------

* Latest information

    The latest information is released on the "RICOH THETA Developers" website.

    https://developers.theta360.com/

----------------------------------------

* Troubleshooting

    FAQs are available on the forums.

    https://developers.theta360.com/en/forums/viewforum.php?f=6

----------------------------------------

* Trademarks

    The products and services described in this document are the trademarks or registered trademarks of their respective owners.

    * Android, Android Studio and Nexus are the trademarks or registered trademarks of Google Inc.
    * Eclipse is the trademark or registered trademark of Eclipse Foundation, Inc. in the United States and other countries.
    * Wi-Fi is the trademark of Wi-Fi Alliance.

    All other trademarks belong to their respective owners.

----------------------------------------

* Update History

    10/15/2015 0.3.1 Bug Fix(Lollipop API Connection)
    02/20/2015 0.3.0 Spherical viewer function added to the sample app
    11/06/2014 0.2.0 Documents are translated
    10/28/2014 0.1.0 Initial release