VRHandsFrame

日本語ページ

Use Google Cloud Vision API

VRHandsFrame enables image and text recognition by Google Cloud Vision API (hereinafter referred to as Vision API).

The Vision API enables text recognition with higher accuracy than the default state, but with the following implementation conditions and precautions.

  • Google Cloud Platform and Google account integration (cell phone number and credit card or Paypal account required)
  • 1001 After the first character recognition, a pay-as-you-go fee may be charged.

Google Cloud Platform (GCP) operation is at the user’s own risk.

*These are the installation procedures as of May 2022; changes in Google’s specifications or updates to VRHandsFrame may result in changes to the procedures.

Index

  1. Google Cloud Platform (GCP) and Google account integration
  2. Enable Cloud Vision API
  3. Obtaining API Key
  4. Setting API Key to VRHandsFrame
  5. GCP Trial Period and Full Account Activation
  6. Vision API usage limits and prices

1. Google Cloud Platform (GCP) and Google account integration

Link GCP and your Google accounts.

Please login to the Google account you wish to use GCP with in advance.
If you use Chrome browser, please log out other accounts from Chrome.

After that, please open this link while logged in to the Google account you wish to Link GCP with. Follow the instructions to link GCP to your Google account.

To link accounts, a “cell phone number” for SMS verification and a “credit card or Paypal account” for payment billing are required.

After your Google account has been linked, you will be asked to answer a question.
To simplify the process, please answer the following.

Q:What brought you to Google Cloud?
Use specific products, services, and/or APIs

Q:What are you interested in doing with Google Cloud?
“Other APIs (e.g., Text-to-Speech, Speech-to-Text, Vision)”

You may skip the GCP tutorial.

2. Enable Cloud Vision API

From the left menu of GCP Home, select “Enabled APIs & services” under “APIs & Services”.


On the next page, select “ENABLE APIS AND SERVICES”.


On the next page, select “Cloud Vision API”. If it is not listed, search for “Vision” in the search box.

Then, the Cloud Vision API Overview page will open. Click on “ENABLE”.

After a short while, the page will automatically switch to enable the Cloud Vision API.

3. Obtaining API Key

Obtain the API Key to be set for VRHandsFrame.

From the Cloud Vision API details page, select “Credentials”.


On the next page, select “API key” under “CREATE CREDENTIALS”.

Then, an API key will be created. Copy the created API key.


If you want to check your API key later, click “SHOW KEY” on Credentials page.

4. Setting API Key to VRHandsFrame

Set the API Key copied in section 3 to VRHandsFrame, and edit the config file for Vision API directly with a text editor. The config file for Vision API is saved as a json format file in the following path.

\VRHandsFrame_Data\StreamingAssets\config\vision_api.json

Paste the API Key copied in step 3 into the “key” parameter value in the config file.
Do not change the “updateAt” and “ocrCount” parameters from their default settings.

Be sure to close the text editor after editing the config file; leaving the config file open may prevent you from using the Vision API.

Finally, on the VR Dashboard, turn on the “Use Google Cloud Vision API for Text Recognition” item on the “詳細設定 2” tab.

If the settings from section 1 to 4 are done correctly, you will be able to use the Vision API on VRHandsFrame. However, be sure to activate your full account if you wish to continue using the API, as the API will stop when the GCP trial period ends. (Explained in the next section)

5. GCP Trial Period and Full Account Activation

The first time you link your Google account to GCP, you will receive a 90-day trial period (plus $300 in GCP credits).

After the trial period ends, the API Key you created will no longer be available. If you wish to continue using the API Key, please follow the steps below to activate your full GCP account.

From the left menu of the GCP Home, select “Billing”.

On the next page, click on the blue button “UPGRADE” in the lower right corner.

Finally, select “ACTIVATE” to activate the full account.

6. Vision API usage limits and prices

The Vision API is available free of charge for the first 1,000 monthly requests; VRHandsFrame uses the Vision API for “Text Detection”.

After 1001 times, a fee of $1.5 * [number of units] per month will be charged to the Google account linked with GCP, with 1000 times as one unit. Please be careful.
The credit 300$ added at the time of account linking will be preferentially used for payment, so I think there will be no sudden occurrence of a high bill.

The number of monthly Vision API executions counted by VRHandsFrame is displayed on the “詳細設定 2” tab on the VR Dashboard. This number may differ from the actual number of API executions, so please use this number only as a reference. The execution count display is reset at the beginning of each month.

The number of API executions counted by VRHandsFrame is stored in the vision_api.json file as well as the API Key. When upgrading VRHandsFrame, overwrite the old vision_api.json file to the same location in the new version’s.