マニュアル

はじめに

左側のサイドバーには、対応するセクションへのリンクが含まれています:

  • ユーザー名 - 個人プロファイルへのリンク。
  • ダッシュボード - チャートやグラフの形式で現在の状況を表示します。
  • アプリケーション - アプリケーションの管理。
  • ロック解除コード - 自動生成された、またはアップロードしたロック解除コード。
  • 支払い - ユーザーの受信支払い履歴。
  • マニュアル - このユーザーマニュアル。

ダッシュボード

ダッシュボードのすべてのウィジェットに共通のフィルターを設定できます:

  • 通貨 - ダッシュボード上での受信および送信金額が変換される通貨。
  • 期間 - ダッシュボードのチャートやテーブルに表示されるデータの期間。支払い、アプリケーション、その他のパラメータに関する情報と統計が分析および表示される期間を指定します。

残高

このダッシュボードセクションでは、出金可能な主要な財務指標が表示されます。ここでは、決済システムおよびPayToUseサービスによって差し引かれた手数料を考慮した上で、すべてのユーザーからの支払いの集計情報が表示されます。

このブロックには、以下の金額が表示されます:

  • 総額:選択した期間における、手数料が差し引かれる前の、すべてのユーザーからの支払額の合計。
  • 正味額:選択した期間におけるすべての支払額の合計から、決済システム手数料およびPayToUseサービス手数料を差し引いた金額。
  • 保留中:まだ出金できない支払いの純額です。資金は、支払いから7日後に出金可能になります。
  • 利用可能額:お客様の口座へすでに出金可能なすべての支払いの合計純額です。これは、実際に出金可能な残高を示す主要な指標です。

テストの支払いは、上記の4つの金額すべて、および下記の支払いウィジェットから除外されます - 実際のお金が動くことはありません。

出金

利用可能残高の表示の下に、「出金」ボタンがあります。このボタンは、獲得した資金の送金リクエストを送信するために使用します。

このボタンをクリックすると、送金に必要な支払情報を指定するモーダルウィンドウが表示されます。

重要なお知らせ:システムは、該当する欄に表示されている利用可能残高の全額を自動的に出金額として使用します。利用可能残高を下回る任意の金額を指定することはできません。出金総額は、「出金可能」ステータスにあるすべての支払額の合計となります。

モーダルウィンドウでは、出金金額と通貨を選択できます。利用可能な通貨は、ご利用の決済方法によって異なります。

注:選択した通貨が指定された出金方法に対応していない場合、出金リクエストは却下されます。

出金リクエストのステータスや履歴に関する詳細については、「出金」セクションをご確認ください。

支払い

支払いウィジェットには、選択した期間のアプリケーション別にグループ化された支払いのテーブルが含まれています。

テーブルのフィールド:

  • アプリケーション - アプリケーション。選択した期間中に支払いが行われたアプリケーションのみがテーブルに表示されます。
  • 支払い - 支払いの数。
  • 総額 - 選択した期間のすべてのユーザー支払いの合計額(決済システムおよびPayToUseの手数料を差し引く前)。
  • 純額 - 選択した期間のすべての支払いの合計額(決済システムおよびPayToUseの手数料を差し引いた後)。

グラフは、純額 と 総額 の値の日別の動向を示します。

新規ユーザー

新規ユーザーのグラフは、日別の動向で2つの値を示します:

  • 新規ユーザー - 新規API呼び出しの数。APIアクセスは、リクエストをAPIに送信する際に device パラメータ(ユニークなデバイス識別子)が渡された場合にのみ記録されます。このパラメータはデバイスごとに本当にユニークである必要があります。 (リクエストの送信 参照)
  • 支払い - 同じ期間内の日別支払いの数。

コンバージョン

コンバージョン指標は、新規ユーザー がどれだけ効率よく 支払い に転換されるかを示します。

グラフは、支払い の数と 新規ユーザー の数の割合をパーセントで示します。

アプリケーション

このセクションに移動すると、アプリケーションのリストが表示されます。

アプリケーションテーブルの列のリスト:

  • # - ユニークなアプリケーション識別子。アプリケーションコードの検証や支払いフォームの表示時に使用されます。
  • 名前 - アプリケーション名。レポートやダッシュボードであなただけに表示されます。アプリケーション名をクリックすると、アプリケーションの編集ページが開きます。
  • ステータス - アプリケーションの現在のステータス。セットアップウィザードがどこまで進んだかを示します。次のいずれかです:
    • 作成済み - アプリケーションが作成されたばかりで、アプリケーション の手順がまだ完了していません。
    • 説明 - 説明 の手順がまだ完了していません。
    • 価格 - 価格 の手順がまだ完了していません。
    • テスト - すべての設定手順が完了していますが、アプリケーションはまだ起動されていません。テスト支払い に使用できます。エンドユーザーはアクセスできません。
    • 起動 - アプリケーションは起動しており、実際の支払いを受け付けています。
  • 作成済み - アプリケーションの作成日。
  • 追加の制御ボタン:
    • 削除 - アプリケーションをリストから削除するためのボタン。

アプリケーションの作成または編集

支払いを受け付けるには、アプリケーションに必要なすべてのデータを順に入力し、アプリケーションを有効にする必要があります。

新しいアプリケーションを作成するボタンは、アプリケーションリストのタイトルバーにあります。

アプリケーション

アプリケーションを作成する際に利用可能なフィールド:

  • 名前 - レポートやダッシュボードであなただけが見ることができるアプリケーションの名前。保存されたアプリケーションのページヘッダーに表示されます。アプリケーションが保存されていない間は、「新しいアプリ」と表示されます。このフィールドは入力必須です。
  • 連絡先メール - ユーザーに送信されたメッセージのコピーが送信されるメールアドレス。このアドレスは「返信先」フィールドにも指定され、ユーザーがコード付きの受信メールに返信するために使用されます。このフィールドは入力必須です。デフォルトでは、開発者プロファイルの値が入力されますが、異なる値に変更することもできます。
  • アプリケーションタイプ - アプリケーションの種類:
    • 個別 - 独自の支払いフォームと独自のロック解除コードを持つ通常のアプリケーション。
    • 1つのアプリに対するキー付きグループ - 複数のアプリケーションに対する1回の購入。ユーザーはグループの支払いフォームで1回支払い、コードはグループ内のいずれか1つのアプリケーションで有効化できます。1つのアプリケーションで有効化すると、他のアプリケーションではコードが利用できなくなります。
    • すべてのアプリに対するキー付きグループ - 複数のアプリケーションに対する1回の購入。ユーザーはグループの支払いフォームで1回支払い、グループ内のすべてのアプリケーションで使える1つのコードを受け取ります。コードは各アプリケーションで個別に有効化され、デバイスに紐付けられます。コードの期間は共通で、グループ内のいずれかのアプリケーションでの最初の有効化から計算されます。
  • グループのアプリケーションのリスト - グループの種類で表示されます。リストからアプリケーションを選択し、追加 をクリックします。グループには少なくとも2つのアプリケーションを追加する必要があります。リストには、ロック解除コードが生成されるご自身の単独アプリケーションのみが表示されます。グループの各アプリケーションにグループコードのコピーが作成され、ロック解除コードのリストではこれらのコードがグループコードの下にステータス 不明 で表示されます。
  • 支払い時のフィードバックを有効にする - ユーザーが自由なテキストを入力できるフィールドを支払いフォームに追加します。フィードバックは開発者向けのメールのコピーに追加されます。支払いの詳細でもフィードバックを確認できます。

変更は入力や値の変更に応じて自動的に保存されます。「保存」ボタンはありません。保存できなかった場合にのみメッセージが表示されます。後からいつでも戻って変更できます。

ステップはページのヘッダーで切り替えます。ヘッダーはスクロールしても上部に残ります。現在のステップが入力されると次のステップが利用可能になり、移動すると現在のステップが保存されます。

説明

リストから言語を選択し、追加ボタンをクリックします。

選択した言語のローカライズされたアプリケーションテキストのタブが表示されます。

利用可能な言語:

  • ドイツ語
  • 英語
  • フランス語
  • スペイン語
  • ロシア語
  • 中国語(簡体字)

説明文のフィールドは、支払いフォーム上やユーザーへの返信メッセージに情報を表示するために使用されます:

  • ローカライズされた名前 - 選択された言語のアプリケーション名。支払いフォームおよび支払い通知メールに表示されます。言語を追加すると、デフォルトでアプリケーション名が挿入されます。各言語ごとに異なる名前を設定することができます。必須フィールドです。
  • アプリケーションの説明 - アプリケーションの簡単な説明。アプリケーション名の下に支払いフォームに表示されます。オプションのフィールドです。説明を表示したくない場合は空白のままにしておくことができます。
  • 購入確認メッセージ - 支払いが成功した場合にユーザーに送信される追加情報。応答テキストは標準の応答の後にメールの末尾に追加されます。

少なくとも1つの言語を追加して保存し、次のページに進む必要があります。

支払いフォームの言語は、ユーザーのブラウザー設定に基づいて自動的に決定されます。いずれかの言語を、そのタブの横にあるラジオボタン(ツールチップ デフォルトを使用)でマークしてください。ユーザーの言語が追加された言語にない場合、その言語のテキストが表示されます。

言語を削除するには、そのタブの削除ボタンをクリックし、削除を確認します。

変更は入力や値の変更に応じて自動的に保存されます。「保存」ボタンはありません。保存できなかった場合にのみメッセージが表示されます。後からいつでも戻って変更できます。

ステップはページのヘッダーで切り替えます。ヘッダーはスクロールしても上部に残ります。現在のステップが入力されると次のステップが利用可能になり、移動すると現在のステップが保存されます。

価格

このページには価格の一覧と支払いに関連するフィールドが含まれています:

  • 試用期間 - トライアル期間の長さ。
  • 時間の単位 - トライアル期間の時間単位。例えば7日を指定すると、アプリケーションの最初のAPI呼び出しから7日後に、トライアル期間が終了したという応答が返されます。デバイスの最初の呼び出し時刻が保存されます。
  • 価格計算方法 - リストから選択する価格計算方法:
    • 期間に応じた価格計算 - 支払いフォームでは、ユーザーはコードの有効期間を指定し、価格は以下の表に従って自動的に計算されます。ユーザーは応答メールで自動生成されたロック解除コードを受け取ります。
    • 価格に応じた期間計算 - 支払いフォームでは、ユーザーはリストから価格を選択するか、独自の価格を入力し、期間は以下の表に従って自動的に計算されます。ユーザーは応答メッセージで自動生成されたコードを受け取ります。
    • 永久コード - 支払いフォームでは、ユーザーはリストから価格を選択するか、独自の価格を入力します。支払い後、選択した価格に対応する以下のリストからコードを応答メールで受け取ります。
    • 寄付 - 支払いフォームでは、ユーザーはリストから価格を選択するか、独自の価格を入力します。寄付タイプのアプリケーションでは、ロック解除コードは生成されません。
    • 期間に応じた価格の一時コード と 価格に応じた期間の一時コード - アプリケーションは API からデバイス用の一時コードを受け取り、支払いフォームにつながる QR コードとともにユーザーに表示します。ユーザーはこのコードの代金を支払います。上記の方法と同様に、価格は選択した期間によって決まるか、期間は支払った価格によって決まります。支払い後、コードはこのデバイスでのみ有効化されます。このようなコードはリセットしたり、別のデバイスに移したりすることはできません。

グループアプリケーションでは、期間に応じた価格計算 と 価格に応じた期間計算 の方法のみ利用できます。寄付 の方法では試用期間は使用されません。

価格表 テーブルで価格帯を設定します。追加 ボタンで行を追加し、削除 ボタンで削除します。テーブルの列は価格計算方法によって異なります:

  • 期間, 価格 - コードの期間(数値と時間の単位:日、月、年、または無期限)とその価格。
  • 価格, コード - 永久コード の方法の場合:価格と、その支払い後にユーザーが受け取るコード(最大12文字)。
  • 価格 - 寄付 の方法の場合:提案金額のみ。

ラジオボタン(ツールチップ デフォルトを使用)でマークされた行が、支払いフォームであらかじめ選択されます。

価格は米ドルで設定されています。最低価格は1米ドルです。

変更は入力や値の変更に応じて自動的に保存されます。「保存」ボタンはありません。保存できなかった場合にのみメッセージが表示されます。後からいつでも戻って変更できます。

ステップはページのヘッダーで切り替えます。ヘッダーはスクロールしても上部に残ります。現在のステップが入力されると次のステップが利用可能になり、移動すると現在のステップが保存されます。

プレビュー

このページでは以下の値が設定されます:

  • コードの長さ - 必要に応じて生成されるコードの長さ。
  • コード文字セット - コード生成に使用される文字のセット:
    • 数字コード - コードは数字 0、1、2、3、4、5、6、7、8、9 のみを使用して生成されます。コードの先頭にゼロが含まれる場合があります。コードの検証時には先頭のゼロも区別されます。
    • 英数字コード - コードは文字 1、2、3、4、5、6、7、8、9、A、B、C、D、E、F、G、H、I、G、K、L、M、N、P、Q、R、S、T、U、V、X、Y、Z を使用して生成されます。コードは大文字で生成され、ユーザーに送信されます。文字の大小はコードの検証時には関係ありません。
  • コードの先頭のゼロを許可 - 生成されるコードの先頭にゼロを許可します。文字セットが数字コードの場合のみ使用できます。
  • デバイスIDによるコードの再送信を許可 - デバイス識別子の確認を繰り返すことで、同じメールアドレスにコードを再送信できるようにします。単一アプリケーションでのみ使用できます。
  • ウォッチフェイスデザイナー - このアプリはデザイナーで作成したウォッチフェイスです。このステップでは支払いリンクとコード例の代わりにデザイナーが表示されます。トップページから作成したウォッチフェイスではオンになっています。
  • リリース日 - アプリケーションが一般ユーザーに利用可能になる日付です。リリース後にベータテスターには無料 と組み合わせて、この日付より前にアプリケーションにアクセスしたデバイスの無料期間を定義します。
  • リリース後にベータテスターには無料 - 時間の単位 より前に最初のAPI呼び出しを行ったデバイスに付与される無料期間の長さ(選択したリリース日で指定)です。そのようなデバイス用に作成されたコードは不明ステータスになります。
  • コードをチェックするリンク - コード検証に使用するサンプルリンク。
  • 支払いリンク - 支払いリンクです。リンクをコピーして、アプリケーションが公開されているウェブサイトの説明欄に貼り付けることができます。各ドメイン(すべてのロケール向けのhttps://pay-to-use.com、ロシア語ロケール専用のhttps://pay-to-use.ru)ごとに、リンク欄の上のタブから利用できる個別のリンクとQRコードが生成されます。 渡されるパラメータ:
    • app - アプリケーションの固有の識別子。必須パラメータ。
    • amount - 購入時に価格フィールドに指定される金額です。デフォルト価格は無視されます。ただし、金額は最低価格より低くすることはできず、アプリケーションに設定された最低価格以下にすることもできません。オプションのパラメータです。

支払いリンク リンクは、アプリケーションが起動されるまで一般には公開されません。それまでは、下のテスト支払いボタンを使用して、署名付きの一時的なアクセストークンで支払いフォームを開いてください。実際のフォームや支払い方法と同じですが、実際には課金されません。支払いはテストステータスで直接作成され、(該当する場合)完全に機能するコードが即座に生成され、支払いシステムを介さずにメールで送信されます。テスト支払いは支払いの一覧に表示され、テストステータスが付きますが、残高の合計には含まれません。

テスト支払いボタンをクリックすると、テスト支払いフォームを開くドメイン(https://pay-to-use.comまたはhttps://pay-to-use.ru)を選択するドロップダウンが表示されます。どちらも同じように機能し、選択が重要になるのはロケール固有の動作をテストする場合のみです。

実際の支払いの受け付けを開始するには、テストモード をオフにします。その前に、入力したデータがすべて正しいことを確認してください。アプリケーションが生成したキーは変更できません。テストモードがオンの間は、アプリケーション名の横に テスト バッジが表示されます。テストモード を再びオンにすると(確認後)、実際の支払いの受け付けが停止し、テスト支払い ボタンが再び使用できるようになります。

コードの確認

アプリケーションのロック解除コードの確認は、以下の3つのステップで行います:

  1. コード確認のためのリクエストの作成と送信
  2. API側のチェック
  3. APIレスポンスの受信と処理
リクエストの送信

コードを確認するには、アプリケーションのユーザーがアプリケーション設定のフィールドに入力する必要があります。

/resources/settings/properties.xml
<properties>
	<property id="UnlockCode" type="string"></property>
	<property id="UnlockResult" type="string">Checking...</property>
	...
<properties>
/resources/settings/settings.xml
<settings>
	<setting propertyKey="@Properties.UnlockCode" title="@Strings.UnlockCode">
		<settingConfig type="alphaNumeric" maxLength="12"/>
	</setting>
	<setting propertyKey="@Properties.UnlockResult" title="@Strings.UnlockResult">
		<settingConfig type="alphaNumeric" readonly="true"/>
	</setting>
	...
</settings>

次に、Pay-to-use APIサーバーにリクエストを送信する必要があります:

/source/background.mc
function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	return Toybox.Communications.makeWebRequest(
		"https://api.pay-to-use.com", // API URL
		{
			"device" => ds.uniqueIdentifier, // デバイス固有の識別子
			"app" => "6", // あなたのアプリケーションID
			"model" => ds.partNumber, // 機器の型番
			"code" => Application.Properties.getValue("UnlockCode") // あなたのアプリケーション内のロック解除コードの値
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

APIリクエストパラメータ:

  • url - https://api.pay-to-use.com。HTTPSの使用は必須です。
  • リクエストの本文(渡される値)。キーと値からなる辞書:
    • device - デバイスの固有識別子。
    • app - あなたのアプリケーションの固有識別子。
    • model - デバイスモデル識別子。オプションのパラメータ。このデータは、新しいデバイスの統計情報を表示するために使用されます。
    • code - ユーザーがあなたのアプリケーション設定で入力したロック解除コード。
  • リクエストオプション:
    • :method - APIはGETおよびPOSTリクエストメソッドをサポートしています。
    • :headers - POSTメソッドの場合、パラメータはJSON形式で渡す必要があります。
    • :responseType - レスポンスはJSON形式で返されます。
  • responseCallback - 2つの引数を受け取るコールバックメソッドへの参照:
    • responseCode - サーバーレスポンスのヘッダーコード。
    • data - リクエストが成功した場合のコンテンツ、またはnull。
API側のチェック

パラメータがAPIに渡されない場合、APIはHTTP/1.1 404 Not Foundヘッダーを返します。

少なくとも1つのパラメータがAPIに渡された場合、APIはHTTP/1.1 200 OKヘッダーを返します。

サーバーレスポンスは以下から成り立っています:

  • response - レスポンスコード
  • msg - レスポンスのテキストによる説明
  • expires - UNIXTIMEタイムスタンプ(該当する場合)

渡されたアプリケーション識別子が正しいことを確認するためのチェックが行われます。 支払い時点でアプリケーションはリリース済みステータスである必要があります。 エラーの場合、レスポンスコード301が返されます。

ユニークなデバイスIDが送信された場合、そのデバイスIDが検索され、保存されます。 確認または保存時にエラーが発生した場合、エラーコード402が返されます。 このようなリターンコードを受け取った場合は、直ちに [email protected] のサポートまでご連絡ください

コードが渡された場合、期間に応じた価格計算および価格に応じた期間計算の計算方法を持つアプリケーションに対して以下のステップが実行されます:

  • 空のコードが送信された場合、前のステップで定義されたユニークデバイス識別子から切り離されます。
  • 空でないコードが送信され、それがアクティブ化されていない場合、アクティブ化の日付に関係なく、購入時に指定された価格の条件に従ってコードがアクティブ化されます。
  • コードが送信されなかった場合、または送信されたコードが見つからない場合、エラーコード201が返されます。
  • アクティブ化されたコードはデバイスと照合され、アクティブ化中に保存されたものと異なるユニークデバイス識別子が送信された場合、エラーコード202が返されます。
  • 送信されたコードに有効期限がなく、すべての前のチェックが合格した場合、コード101が返されます。
  • コードが時間制限されている場合、チェックが行われます。キーが有効期限切れでない場合、コード101が返されます。コードが期限切れの場合、エラーコード203が返されます。
  • このタイプのアプリケーションでは、コードをデバイスにバインドする必要があります。ユニークなデバイスIDが送信されていない場合、エラーコード304が返されます。

永久コードを持つアプリケーションの場合、購入時のコードの可用性のみがチェックされます。 コードが見つかれば、コード101が返されます。コードが見つからない場合、エラーコード201が返されます。

寄付計算方法を持つアプリケーションの場合、コードはチェックされません。 コード101が常に返されます。

空のコードが送信され、アプリケーションの リリース日 フィールドが設定されている場合、ベータテスター期間がチェックされます。デバイスがリリース日より前に初めて API にアクセスし、リリース後にベータテスターには無料 の期間がまだ終了していなければ、コード 103 が返されます。

デバイスIDによるコードの再送信を許可 オプションが有効でコードが送信されない場合、デバイスにすでに紐付けられている有効なコードが検索されます。見つかった場合、コード 101 がそのコード自体とともに返されます。

前のチェックに合格しなかった場合は、試用期間がチェックされます。 デバイスの最初のアクセスからの経過時間が現在のアプリケーション設定の期間を超えている場合、エラーコード204が返されます。 試用期間がまだ終了していない場合、エラーコード102が返されます。

アプリケーションIDのみが送信され、ロック解除コードもユニークデバイスIDも送信されない場合、エラーコード303が返されます。

返されたレスポンスが500の場合は、[email protected] のサポートまでご連絡ください

以下にすべての返されるコードの表があります:

コード メッセージ
101 期間に応じた価格計算と価格に応じた期間計算の計算方法:
  • 永久アクティブ
{
	"response":101,
	"msg":"Active forever",
	"expires":0
}
  • [日付]までアクティブ
{
	"response":101,
	"msg":"Active until 10 Dec 2026",
	"expires":1796868466
}
永久コード:
{
	"response":101,
	"msg":"The code check was successfull",
	"expires":0
}
寄付:
{
	"response":101,
	"msg":"No code check required",
	"expires":0
}
102
{
	"response":102,
	"msg":"Trial period expires in 8h 23m",
	"expires":1795084288
}
103
{
	"response":103,
	"msg":"Free for beta tester until 27 Dec 2026",
	"expires":1798337266
}
201
{
	"response":201,
	"msg":"Code not found"
}
202
{
	"response":202,
	"msg":"Used on the another device"
}
203
{
	"response":203,
	"msg":"Expiration: 30 Sep 2026",
	"expires":1790734066
}
204
{
	"response":204,
	"msg":"Trial period expired"
}
301
{
	"response":301,
	"msg":"Application not found"
}
302
{
	"response":302,
	"msg":"Term undefined"
}
303
{
	"response":303,
	"msg":"Not enough arguments"
}
304
{
	"response":304,
	"msg":"Device is nesessary"
}
401
{
	"response":401,
	"msg":"Error code saving"
}
402
{
	"response":402,
	"msg":"Error device saving"
}
500
{
	"response":500,
	"msg":"Unknown error"
}
応答の確認

次に、Pay-to-use APIサーバーからの応答を確認する必要があります:

/source/background.mc
function onReceive(responseHeader, data) as Void {
	if (responseHeader == 200) { Toybox.Background.exit(data); }
}

すべてのヘッダーとコードを確認し、ユーザーの利便性のために独自のメッセージを表示することができますが、最も単純な形式では、確認は次のようになります:

/source/app.mc
function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// "UnlockResult"という名前のプロパティフィールドでdata["msg"]を表示することができます。
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// コードの検証に失敗しました
			// 有料機能は利用できません
			...
		} else {
			// コードのチェックが成功したか、エラーの原因があなたの側またはAPI側にあります
			// 有料機能が利用可能です
			...
		}
	}
}

ロック解除コード

このセクションに移動すると、ロック解除コードのリストが表示されます。

ロック解除コードのリスト

トップの検索バーでメールフィールドまたはコードを検索できます。見つかったコードはリストに表示されます。メールまたはコードの全体または一部を検索基準として使用できます。一致する部分は色で強調表示されます。検索とフィルターは同時に動作し、互いを排除しません。

最後に使用したフィルターはユーザーのために保存されます。つまり、次回ページにアクセスすると、最後に使用したフィルターが自動的に適用されます。ロック解除コードのリストには、以下のフィルターがあります:

  • 列 - ロック解除コードのリストで表示するテーブル列を選択します。
  • アプリケーション - 選択したアプリケーションのロック解除コードのみを表示します。
  • ステータス - 選択したステータスにあるロック解除コードのみを表示します。

ロック解除コードのテーブルの列のリスト:

  • アプリケーション - あなたのアプリケーション。リンクをたどってその設定を編集できます。
  • コード - ロック解除コード。
  • メール - ロック解除コードの登録に関連付けられたメールアドレス。このアドレスは、ウェブサイトの購入履歴セクションで顧客のロック解除コードを検索するために使用されます。このセクションはユーザーにアクセス可能です。
  • 期間 - 送信されたコードの有効期間(アプリケーション設定で指定)。コードの有効期間は、その作成時点でのアプリケーション設定の条件に対応して設定されます。
  • ステータス - ロック解除コードのステータス。 (ロック解除コードのステータス 参照)
  • 作成済み - ロック解除コードの作成日。
  • 言語 - ユーザーの言語。コードを含むメッセージに使用されます。
  • アクティベーション - コードのアクティベーション日付。この特定のユーザーデバイスが最初にPayToUse APIサービスに連絡し、このコードを送信した時点で設定されます。コードのステータスはアクティブに変更されます。非アクティブなコードのみをアクティベーションできます。異なるIDを持つデバイスがアクティブなコードを送信した場合、APIはエラー202を返します。1つのコードには1つのデバイスのみをリンクできます。
  • 有効期限 - コードのアクティベーションが有効期限切れになる日付。コードのアクティベーション時に有効期限が設定されるコードに対して設定されます。無期限の場合は空白のままです。
  • 削除済み - コードの削除日付。削除時にコードのステータスが不明に設定されます。
  • デバイス - コードが紐付けられているデバイスの一意の識別子。
  • デバイスの初回アクセス - デバイスからの最初の API 呼び出しの日付。試用期間とベータテスター期間はこの日付から計算されます。
  • デバイスの最終アクセス - デバイスからの最後の API 呼び出しの日付。アプリケーションがまだ使用されているかを確認できます。
  • 支払い # - 支払いの一意のシーケンス番号。リンクをクリックして支払いの詳細を表示できます。
  • 注釈 - コードを手動で作成したときに入力したメモ。
  • ロック解除コードに関する操作用のボタン。例えば、削除。

ロック解除コードのステータス

ロック解除コードはそのライフサイクルの中で異なる状態を経験し、それらはコードのステータスによって追跡することができます。

ステータス 説明
利用可能 このステータスは、ロック解除コードに対して何のアクションも実行されていない場合、またはデバイスのリンクがコードに対してリセットされた場合に割り当てられます。
アクティブ このステータスは、設定されたアクティベーション日付を持つコードに対して設定されます。デバイスが初めてPayToUse APIサービスに正常にアクセスした時にアクティベーション日付が設定されます。また、コードのアクティベーション時にコードの有効期限も設定されます。
期限切れ このステータスは、期限切れのコードに設定されます。デバイスからコードのリンクを解除しても、コードの有効期限はリセットされません。このステータスのコードを確認すると、エラー203が返されます。 (API側のチェック 参照)
不明 このステータスは、コードが削除された時に設定されます。このステータスのコードを確認すると、エラー201が返されます。 (API側のチェック 参照)
不明 このステータスは、アプリケーションのリリース日より前に最初のAPI呼び出しを行ったデバイス用に作成されたコードに設定されます - 通常の試用期間や有料アクティベーションの代わりに、リリース後にベータテスターには無料で設定された無料期間が付与されます。
不明 このステータスは、グループ化された複数のアプリケーションで共有されるコードに設定されます。単一のアプリケーションに紐付いておらず、グループ内の個々のアプリケーションのコード一覧には表示されません。
不明 不明 と同じですが、コードはもう利用できません。削除されたか、1つのアプリケーションのみのキーを持つグループの場合は、グループ内のいずれかのアプリケーションですでに有効化されています。グループコードを削除すると、グループ内のすべてのアプリケーションにあるそのコピーも削除されます。
不明 このステータスは、グループ内のアプリケーションに属するコードが個別に削除された際に設定されます。一方、グループ自体のコードは残ります。

コードの詳細

リスト内のコードをクリックすると、コードの詳細ページが開きます。リストと同じフィールドと、コードに対する操作ボタンが表示されます:

  • リセット - コードをデバイスから切り離し、有効化日をリセットします。コードのステータスは 利用可能 に変わり、たとえばユーザーがデバイスを買い替えた場合などに、別のデバイスでコードを有効化できます。すでに有効化されたコードの有効期限はリセットされません。一時コードを使用するアプリケーションでは、このようなコードは1台のデバイスでしか使用できないため、このボタンは利用できません。
  • アクティブ化 - まだ支払われていない一時コードで利用できます。ユーザーのメールアドレスとコードの期間を入力すると、支払われた場合と同様に、コードが紐付けられているデバイスで有効化されます。たとえば、ユーザーにアプリケーションを無料で提供する場合に使用します。
  • コードを送信 - コードとその詳細を記載したメールを、コードのメールアドレスに送信します。メッセージの言語 を選択してください。開発者にコピーを送信 にチェックを入れると、メールのコピーがアプリケーションの連絡先メールアドレスに送信されます。ユーザーがコードの記載されたメールを紛失した場合に使用します。
  • メールを変更 - コードのメールアドレスを変更します。グループコードの場合、グループコードとそのすべてのコピーのメールアドレスが変更されます。コードが支払いによって取得された場合は、支払いのメールアドレスも変更されます。その後、ユーザーは新しいメールアドレスで 購入履歴 セクションからコードを見つけられます。
  • 削除 - コードを削除します。コードのステータスは 不明 に変わり、コードの検証ではエラー 201 が返されます。支払われていない一時コードは完全に削除されます。

支払いに対してコードが送信されている場合、コードに対する操作は支払いの詳細ページでも利用できます。

作成

ロック解除コードのリストのタイトルバーにある 作成 ボタンをクリックすると、支払いなしでコードを作成するフォームが開きます。たとえば、ベータテスター、レビュアー、または別の方法で支払ったユーザー向けです。フォームのフィールド:

  • メール - 作成されたコードの送信先アドレス。メールのコピーはアプリケーションの連絡先メールアドレスに送信されます。
  • アプリケーション - コードを作成する対象のアプリケーション。ステータスが テスト または 起動 で、価格計算方法が 期間に応じた価格計算 または 価格に応じた期間計算 のアプリケーションのみ利用できます。
  • 期間 と 時間の単位 - コードの有効期間。デバイスでコードが有効化された時点から計算されます。
  • 件数 - 作成するコードの数。
  • 注釈 - コードとともに保存される任意のテキスト。リストの 注釈 列に表示されます。
  • メールにメモを含める - コードを記載したメールにメモを追加します。

コードは、アプリケーションのコード設定(長さと文字セット)に従って生成されます。保存後、作成されたコードのリストが表示され、メールが送信されます。

アップロード

アップロード ボタンを使うと、PayToUse 以外で発行されたコードを読み込めます。たとえば、別のライセンスシステムから移行する場合です。アプリケーション、ファイル、ファイルのパラメーターを選択してください:

  • ファイル形式 - CSV、文字コード UTF-8。最大ファイルサイズはアップロードフォームに表示されます。
  • ヘッダーを含む - ファイルの1行目に列名が含まれている場合はチェックを入れます。その場合、1行目はスキップされます。
  • 区切り文字 - セミコロン、カンマ、またはタブ。

ファイルの列(この順序):

  1. コード - ロック解除コード、必須。大文字に変換され、12文字に切り詰められます。アプリケーションにすでに存在するコードはスキップされます。
  2. メール - ユーザーのメールアドレス。
  3. 作成済み - 作成日:日付または UNIXTIME のタイムスタンプ。空の場合はアップロード日が使用されます。
  4. 有効期限 - 有効期限:日付または UNIXTIME のタイムスタンプ。コードがまだ有効化されていないか、有効期限がない場合は空のままにします。
  5. 期間 - 有効化後の有効期間:数値と単位(例:12h、30d、6m、1y)。空の場合、コードは無期限で有効です。

アップロード後、読み込まれた行の表が表示されます。読み込まれなかった行は赤で強調表示され、全体のうち何行が追加されたかがメッセージで表示されます。アップロード時にユーザーへメールは送信されません。

ダウンロード

ダウンロード ボタンをクリックすると、ロック解除コードのリストが CSV ファイルとしてダウンロードされます。フォームで、ファイルに含めるフィールドを選択します。ファイルには、現在のページのコードだけでなく、現在のフィルターと検索に一致するすべてのコードが含まれます。選択したフィールドは次回のダウンロード用に記憶されます。

支払い

このセクションに移動すると、ユーザーの支払いのリストが開きます。

支払いを受け取るために以下の支払いシステムが使用されています:

システム 説明
支払いシステムの手数料は、成功したカードチャージごとに2.9% + 0.30 USDからかかります。カード、ウォレット、その他の支払いオプションがサポートされています。手数料は支払い方法に依存し、カード支払い手数料と異なる場合があります。支払いシステムが請求する手数料の詳細については、支払いシステムのウェブサイトで確認できます。
支払いシステムの手数料は、成功した支払いごとに3.4% + 0.30 USDからかかります。カードとPayPalがサポートされています。支払いシステムが請求する手数料の詳細については、支払いシステムのウェブサイトで確認できます。
支払いシステムの手数料は、成功した支払いごとに3.9%からかかります。カードおよびその他の支払いオプションがサポートされています。手数料は支払い方法に依存します。支払いシステムが請求する手数料の詳細については、支払いシステムのウェブサイトで確認できます。

支払いシステムの手数料を差し引いた後、PayToUseは13%の手数料を請求します。手数料を削減するために常に取り組んでいます。

支払いシステムで紛争や返金が発生した場合、支払いシステムのペナルティは開発者に転嫁されます。したがって、このような状況が発生しないようにしてください。紛争の場合、PayToUseの手数料は請求されません。

支払いリスト

トップの検索バーでメールフィールドまたは送信されたコードを検索できます。見つかった支払いはリストに表示されます。メールアドレスまたは送信されたコードの全体または一部を検索条件として使用できます。一致するものは色で強調表示されます。検索とフィルタは同時に動作し、互いに排他的ではありません。

ユーザーのために最後に使用されたフィルタが保存されます。つまり、次回ページに入ると、最後に使用されたフィルタが自動的に適用されます。支払いのリストには以下のフィルタがあります:

  • 列 - 支払いリストに表示するテーブル列を選択します。
  • 期間 - 選択した日付範囲に作成された支払いのみを表示します。
  • アプリケーション - 選択したアプリケーションの支払いのみを表示します。
  • システム - 選択した支払いシステムからの支払いのみを表示します。
  • ステータス - 選択したステータスの支払いのみを表示します。

支払いテーブルの列のリスト:

  • アプリケーション - あなたのアプリケーション。リンクをたどってその設定を編集できます。
  • # - 支払いの一意の連番です。ユーザーが支払いフォームから支払いページに移動する際に、支払いシステムで自動的に割り当てられます。支払いの詳細を表示するにはリンクをクリックしてください。
  • コメント - 支払いフォームに入力されたユーザーからのメッセージ。
  • システム - ユーザーが選択した支払いシステム。
  • ステータス - 支払いのステータス。 (支払いのステータス 参照)
  • メール - 支払いフォームに記入されたユーザーのメールアドレス。
  • 期間 - 送信されたコードの有効期間(アプリケーションの設定で指定)。
  • 言語 - ユーザーが選択した支払いフォームの言語。
  • 作成済み - 支払いの作成日。
  • 請求金額 - ユーザーに請求された支払いの金額。アプリケーションの設定によって支払いフォームに指定されます。
  • 支払い日 - 支払い日。
  • 支払い金額 - 支払いシステムによって確認された支払いの金額。
  • 送信されたコード - ユーザーに送信されたコード。
  • 利用可能な金額 - 出金可能額。
  • 出金額 - 支払いに対して出金された金額。

支払い詳細

一覧の支払いの#をクリックすると、その詳細ページが開きます。

上記で説明済みのフィールドに加えて、詳細ページには次の項目が表示されます:

  • コード - 購入者が支払いフォームに入力したコードで、確認・アクティベーションが行われる前のものです。デバイスに紐付けられた一時コードを使用するアプリケーションでのみ表示されます。
  • 支払金額(総額) - 決済システムによって確認された金額で、決済システムとPayToUseの手数料を差し引く前のものです。
  • 支払金額(純額) - 決済システムによって確認された金額で、決済システムとPayToUseの手数料を差し引いた後のものです。
  • 支払い識別子 - 決済システムによって割り当てられた識別子で、必要に応じてそこで支払いを照会するために使用します。表示されるフィールドは決済システムによって異なります:
    • Stripe: Payment Intent、レシート番号、下4桁。
    • PayPal: 支払ID、支払人ID、取引ID。
    • Robokassa: 支払ID、ID1、ID2。

支払いに対してコードが送信されている場合、支払いの詳細ページで コードをリセット、コードを送信、メールを変更 ボタンを利用できます。これらはコードの詳細ページと同じように機能します。 (コードの詳細 参照)

支払いのステータス

支払いはそのライフサイクルの中で異なる状態に移行し、支払いのステータスで追跡できます。

ステータス 説明
未完了 このステータスは、何らかのアクションが行われていない支払いに割り当てられます。支払いは、ユーザーが支払いフォームから支払いシステムのフォームに切り替わるとすぐに作成されます。支払いには一意のシリアル番号が割り当てられ、支払いの基本的な属性(金額、支払いシステム、日付)が設定されます。
成功 このステータスは、支払いシステムから肯定的な応答を受けた支払いに割り当てられます。次のステップは、生成されたコードやその他のデータ(アプリケーション設定に依存)を含むユーザーへのメールの送信です。このステータスの支払いが保持されている場合、後続のアクションが実行されていない可能性があるため、特別な注意が必要です。
エラー このステータスは、支払いシステムから否定的な応答を受けた支払いに割り当てられます。その後のステップは実行されません。支払いシステム側のステータスが遅延で処理される可能性があるため、このような支払いに特別な注意が必要です。
保留中 このステータスは、支払いシステムから肯定的な応答を受け、その後のすべてのステップが正常に完了した支払いに割り当てられます。このステータスの支払いに対しては、出金は利用できません。支払いは7日後に自動的に次のステータスに移行します。
利用可能 このステータスの支払いに対しては出金が可能です。
送信中 このステータスは、次回の出金に含まれる支払いに割り当てられます。出金がキャンセルされた場合や拒否された場合、支払いのステータスは利用可能に戻ります。
送信済み このステータスは、出金が行われた支払いに割り当てられます。資金の受領確認が保留中です。
完了済み このステータスは、出金が完了した支払いに割り当てられます。関連するセクションで出金を確認することで、ステータスを手動で設定することができます。支払いの出金後、14日後に自動的にステータスが変更されます。
返金済み 返金が行われた支払いはこのステータスに移行します。返金時には手数料が発生します。手数料は出金金額から差し引かれます。
返金終了 すでに送金済みの出金に含まれていた返金です。出金済みの金額はもう減らせないため、返金手数料は代わりに開発者の残高から差し引かれます。
紛争 購入者が決済システムに対して支払いに異議を申し立てました(チャージバック)。結果は保留中です。
紛争終了 紛争は解決されました。返金の場合と同様に、決済システムが請求する紛争手数料は開発者に転嫁されます。
キャンセル済み 支払いは完了する前にキャンセルされました。
不明 決済記録を決済システムのレポートと照合する際、そのステータステキストが上記の既知のいずれのステータスにも一致しない場合に設定されます。手動での確認が必要です。
テスト アプリケーションが起動する前、テストモードステータスの間に、アプリケーションのテストを通じて行われたテスト支払いです。金額や生成されたコードは実在のものですが、実際には課金されず、この支払いはダッシュボードの合計から除外されます。

ダウンロード

支払いリストのタイトルバーにある ダウンロード ボタンをクリックすると、リストが Excel ファイル(XLSX)としてダウンロードされます。ファイルには、列 フィルターで選択された列が同じ順序で含まれ、現在のページの支払いだけでなく、現在のフィルターと検索に一致するすべての支払いが含まれます。

出金

このセクションに移動すると、出金リストが表示されます。

出金

「出金」ボタンは、獲得した資金の送金リクエストを開始するために使用します。

このボタンをクリックすると、送金に必要な支払情報を指定するモーダルウィンドウが表示されます。

重要なお知らせ:システムは、該当する欄に表示されている利用可能残高の全額を自動的に出金額として使用します。利用可能残高を下回る任意の金額を指定することはできません。出金総額は、「出金可能」ステータスにあるすべての支払額の合計となります。

モーダルウィンドウでは、出金金額と通貨を選択できます。利用可能な通貨は、ご利用の決済方法によって異なります。

注:選択した通貨が指定された出金方法に対応していない場合、出金リクエストは却下されます。

出金リスト

最後に使用したフィルターがユーザーのために保存されます。つまり、次回ページにアクセスすると、最後に使用したフィルターが自動的に適用されます。出金リスト用のフィルターは以下の通りです:

  • 列 - 出金リストで選択した列のみ表示します。
  • ステータス - 選択したステータスにある出金のみ表示します。

出金テーブルの列の一覧:

  • # - 出金の固有シーケンス番号。出金を保存すると自動的に割り当てられます。リンクをクリックして出金の詳細を表示できます。
  • ステータス - 出金のステータス。 (出金ステータス 参照)
  • 作成済み - 出金リクエストの日付。
  • 金額 - 出金金額。
  • 出金 - 出金が送信された日付。
  • 出金に関連するアクションのボタン。例えば、確認。

出金が送信済みの状態の場合、出金を確認できます。

出金詳細

リスト内の出金の # をクリックすると、その詳細ページが開きます。リストのフィールドに加えて、詳細(出金リクエストで指定された、資金の振込先となる支払い情報)が表示されます。

以下は、出金に含まれる支払いのリストです。支払いリストと同様に、列、アプリケーション、システム、ステータス のフィルターを利用できます。 (支払いリスト 参照)

出金ステータス

出金のライフサイクル中、異なる状態になります。これらの状態は、出金のステータスで追跡できます。

ステータス 説明
保留中 出金の作成時、まだ何のアクションも行われていない出金に割り当てられるステータスです。
キャンセル済み キャンセルされた出金にはこのステータスが割り当てられます。キャンセルはさまざまな理由で行われます。たとえば、資金の受け取り方法が指定されていない場合などです。この出金からのすべての支払いは利用可能の状態に移行し、再度出金可能になります。
送信済み 出金が送金されたときに設定されるステータスです。
完了済み 手動出金で、開発者が受け取りを確認したとき、または送金から14日後に自動的に設定されるステータスです。
拒否済み 送金後、銀行や支払いシステムが資金を返還した場合に出金のステータスが設定されます。この出金からのすべての支払いは利用可能のステータスに移行し、再度出金可能になります。

ウォッチフェイスデザイナー

デザイナーを使うと、プログラミングなしでアプリ用のGarmin Connect IQウォッチフェイスを作成できます。各時計モデルの画面に要素を配置し、表示内容と有料にする要素を選んで、完成したファイルをダウンロードします:テスト用に自分の時計へインストールする.prg、またはConnect IQ Storeで公開する.iqです。

完成したウォッチフェイスは、アプリの支払い方法に従ってPayToUseで支払いを自動的に確認します。コードを書く必要はありません。

デザイナーは、アプリのページでアプリ名の横にあるロケットのボタンから開きます。

Connect IQ開発者キー

すべての.prgファイルと.iqファイルは、開発者キー(4096ビットのRSA秘密鍵)で署名されます。キーはプロフィールで一度設定し、開発者のすべてのウォッチフェイスに使用されます。

  • Connect IQ Storeにすでにアプリがある場合は、それらに署名したキーをアップロードしてください:Connect IQ SDKで作成したdeveloper_keyファイルです(例えばVisual Studio Codeの"Monkey C: Generate a Developer Key"コマンドで作成)。ストアで公開したアプリは同じキーでしか更新できません。
  • まだキーがない場合は、「新しいキーを生成」ボタンで生成してください。このキーは時計へのウォッチフェイスのインストールやストアの新しいアプリに使えますが、別のキーで公開済みのアプリをこのキーで更新することはできません。
  • キーをダウンロードし、安全な場所にコピーを保管してください。キーを紛失すると、そのキーで公開したアプリをストアで更新できなくなります。
  • DERまたはPEM形式のファイルに対応しています。キーはパスワードで保護されていない必要があります。

重要:キーを置き換えると、開発者のすべてのウォッチフェイスに影響します。以前のキーはサーバーに保存されますが、新しいビルドは新しいキーで署名されます。

時計モデル

デザイナーで使えるモデルの一覧は、管理者が時計モデルページで設定します:Connect IQ 4以降の丸型および長方形のモデルです。デザイナーではモデルボタンでウォッチフェイスのモデルを選択します。

モデルごとに独自のレイアウトがあります。要素の位置、サイズ、フォントは個別に設定し、要素の一覧、機能、支払い設定はすべてのモデルで共通です。新しく追加したモデルには、現在のモデルのレイアウトが画面に合わせて拡大縮小されて適用されます。

  • 時計 / 画面 - 時計の画像上に画面を表示するか、画面のみを表示します。
  • 実寸 - 時計を実寸で表示します。
  • 常時表示 - AMOLED画面の常時表示モードのプレビュー。

要素一覧

ウォッチフェイスは4種類の要素で構成されます:

  • テキスト - 機能の値を表示します:時刻、日付、歩数、心拍数、天気など。
  • 固定テキスト - 自分で入力するテキスト。
  • 針 - アナログの時針、分針、秒針。
  • 画像 - 画像:背景、または他の要素の上に重ねるレイヤー。

要素は要素一覧タブのリスト順に描画され、最初の要素が最下層になります。順序はリストの矢印と最背面へ・最前面へボタンで変更します。

要素はマウスまたは矢印キーで移動します(1 px、Shiftで10 px)。Ctrl+Dで要素を複製、Ctrl+C / Ctrl+Vで位置を別のモデルにコピー、Deleteで削除します。すべてのモデルにコピーボタンで、要素の位置を選択したすべてのモデルに反映します。 すべてを全モデルにコピーボタンは、他のすべてのモデルのレイアウトを現在のモデルのレイアウト(すべての要素と背景、各画面に合わせて拡大縮小)で置き換えます。

機能と支払い

テキスト要素には複数の機能を設定できます。そのうち1つが既定で表示されます。ユーザーが設定で機能を選択可能を有効にすると、時計のユーザーがGarmin Connectのウォッチフェイス設定で機能を選択します。

各要素の各機能を有料に設定できます。同じ機能を、ある要素では無料、別の要素では有料にできます。機能タブには、使用中のすべての機能と要素が1つの表に表示されます。

アスタリスクの付いた機能には追加の権限(センサー履歴、ユーザープロフィールまたは位置情報)が必要で、ウォッチフェイスのインストール時にストアに表示されます。権限は、そのような機能を使うウォッチフェイスにのみ追加されます。日の出・日の入りや昼/夜のアイコンには位置情報が必要です。ウォッチの最後のGPS位置(GPSを使うアクティビティで更新されます)、なければ天気予報の地点が使われます。

未払いの場合、ウォッチフェイスはアプリの支払い方法に応じて次のように動作します:

支払い方法 未払いの場合
期間に応じた価格計算, 価格に応じた期間計算, 永久コード 有料機能には「paid」と表示され、有料画像は非表示になります。ロック解除コードはウォッチフェイスの設定で入力し、購入ページのQRコードは時計の設定メニューにあります。
期間に応じた価格の一時コード, 価格に応じた期間の一時コード ウォッチフェイスが有料機能を使う場合、時計のコードと支払いページのQRコードを含むロック画面が表示されます。
寄付 支払いチェックはなく、有料の指定は無視されます。

タッチスクリーンでは、ロックされたウォッチフェイスをタップすると、お試しとして15分間すべての機能が使えます。

アイコン

テキスト要素は機能の値の横にアイコンを表示できます。アイコンはウォッチフェイス全体で機能ごとに共通です。要素の機能表のアイコン列または機能タブで変更でき、その変更はこの機能を持つすべての要素に適用されます。

  • 辞書から(既定)- 管理者がアイコン辞書でこの機能に設定したアイコン。
  • アイコンなし - 機能をアイコンなしで表示します。
  • 1つのアイコン - 共通ライブラリまたは独自アイコンの任意のアイコン。
  • セット - アイコンは機能の値によって変わります:「まで」の値が値以上である最初の行が使われ、最後の行はそれより大きいすべての値に使われます。「昼 / 夜」では各行に夜用アイコンがあり、日没から日の出まで使われます。

セットの値:バッテリー - 充電率 %、アラーム - 数、電話接続とおやすみモード - 1 または 0、月 - 月齢(日)、風 - 方向(度)、天気 - 状態コード。その他の機能 - 単位なしの数値。充電中はバッテリーアイコンが順番に表示されます。

要素の表示設定で、テキストとアイコン、テキストのみ、アイコンのみを選びます。テキストに対するアイコンの位置、サイズ、色、間隔、オフセットはモデルごとのレイアウトで設定します。 要素の配置は、テキスト・間隔・アイコンを合わせたブロック全体に適用されます。

独自のアイコンはウォッチフェイスタブのウォッチフェイスのアイコンセクションで追加します:SVG ファイル(複数同時に可)または TTF フォント(各文字がアイコンになります)。SVG の要件:

  • アイコンは単色です。ファイルの色は無視され、デザイナーで選んだ色で描画されます。
  • 塗りつぶした図形のみ使われます。塗りのない線(stroke)はベクターエディタで図形に変換してください(例:Inkscape の「オブジェクトのストロークをパスに」、Figma や Illustrator の「Outline Stroke」)。
  • 穴は実際の切り抜き(複合パスまたは evenodd 塗りつぶし規則)にしてください。黒い図形の上の白い図形は塗りつぶし領域になります。
  • アイコンのサイズはファイルの viewBox です。グラデーション、マスク、テキスト、CSS クラスはサポートされません。

ウォッチフェイスのビルド時に、アイコンは時計上で必要なサイズのビットマップに変換されます。

フォントと画像

  • 時計のシステムフォントはすべてのモデルで使えます。数字フォントには数字といくつかの記号しか含まれません。
  • 独自の TTF または OTF フォントはウォッチフェイスタブでアップロードし、モデルとサイズごとにビットマップに変換されます。1 つのモデルで使える独自フォントとアイコンのサイズは合計 12 種類までです。
  • 画像(2000×2000までのPNG、JPEG、GIF、WebP)は同じタブでアップロードします。画像はどのモデルでも画面いっぱいに表示するか、独自のサイズを指定できます。モデルごとに拡大縮小され、透明度は保持されます。1モデルあたり最大8種類の画像またはサイズを使えます。
  • 画像は時計のグラフィックメモリを使用します。デザイナーには現在のモデルでの使用量が表示されます。

常時表示モード

AMOLED画面の常時表示モードでは、常時表示モードで表示が有効な要素だけが黒い背景に表示され、画面保護のため毎分少しずつずらされます。Garminではこのモードで点灯するピクセルを10%以下にする必要があり、デザイナーは画面の上にこの値を表示します。このモードでは秒と秒針は表示されません。

ビルド

  • この時計用にビルド (.prg) - 現在のモデル用のファイル。お使いの時計にインストールします。
  • Connect IQ Store 用にビルド (.iq) - Connect IQ Storeで公開するための、選択したすべてのモデル用パッケージ。.iqのビルドごとに新しいバージョン番号が付きます。

ビルドはキューに入り、通常は1分ほどかかります。ビルドタブにステータス、ダウンロードリンク、ビルドログが表示されます。

ウォッチフェイスタブのアプリのUUIDはストアでアプリを識別します。バージョン間で変更しないでください。公開済みのアプリを更新するには、そのUUIDを入力してください。

.prgファイルを時計にインストールする

USBケーブルで時計をコンピューターに接続し、.prgファイルを時計のGARMIN/Appsフォルダーにコピーします。ケーブルを外すと、ウォッチフェイスが時計のウォッチフェイス一覧に表示されます。

  • Windows:時計はエクスプローラーにデバイスとして表示されます(例:"fēnix 7")。Internal Storage → GARMIN → Appsを開いてファイルをコピーしてください。
  • macOS:最近の多くの時計はMTPで接続されますが、macOSは追加ソフトなしではMTPに対応していません。OpenMTP(無料)をインストールして時計を接続し、GARMIN/Appsを開いてファイルをコピーしてください。先にGarmin Expressを終了してください。そうしないと接続を奪われます。
  • Linux:時計はファイルマネージャー(GNOME Files、Dolphin)にMTPデバイスとして表示されます。GARMIN/Appsを開いてファイルをコピーしてください。グラフィカル環境がない場合は、jmtpfsまたはsimple-mtpfsで時計をマウントできます。

ウォッチフェイスを削除するには、GARMIN/Appsからファイルを削除するか、時計上で削除します。

注:この方法でインストールしたウォッチフェイスの設定はGarmin Connectアプリで変更できず、既定の設定が使われます。設定をテストするには、ウォッチフェイスをベータアプリとしてストアで公開してください。

Connect IQ Storeでの公開

デザイナーはストアにファイルをアップロードしません。Connect IQ開発者ダッシュボード(apps.garmin.com/developer)にログインし、"watch face"タイプのアプリを作成して.iqファイルをアップロードし、説明とスクリーンショットを追加して審査に提出してください。

アプリを更新するには、新しい.iqファイルをビルドし(バージョンは自動的に上がります)、同じアプリの新しいバージョンとしてアップロードします。UUIDと開発者キーは同じままにする必要があります。

API

概要

PayToUse APIは次の機能を提供します:

  1. ロック解除コードのアクティベーション状態をチェックし、必要に応じてアクティベーションします。
  2. NightScoutアプリから血糖値データを取得します。
  3. 指定された場所の現在の天気データを取得します。

すべての情報は1回のリクエストで要求して返すことができます。

APIエンドポイント

次のいずれかのエンドポイントを使用できます:

  • https://api.pay-to-use.com
  • https://api.p2u.io

両方のエンドポイントはGETリクエストとPOSTリクエストを処理します。

リクエストパラメータ

  • device: 文字列 (必須) — デバイスの一意識別子
  • app: 整数 (必須) — アプリケーションID
  • model: 文字列 (オプション) — アプリを使用するデバイスの統計情報を収集して表示するために必要なデバイスモデルコード
  • code: 文字列 (オプション) — ロック解除コード
  • bg: 連想配列 (オプション) — NightScoutアプリから血糖レベルをリクエストするためのデータ
    • url: 文字列 (オプション) — NightScoutアプリのアドレス
  • weather: 連想配列 (オプション) — 現在の天気をリクエストするためのデータ
    • appid: 文字列 (オプション) — 天気APIアクセスキー
    • lat: float (オプション) — 緯度
    • lon: float (オプション) — 経度
    • provider: 整数 (オプション) — 天気プロバイダー

サポートされている天気プロバイダーのリスト

1. OpenWeatherMap

  • 説明: OpenWeatherMapは、リアルタイム気象データ、歴史的データ、16日間の予報を含む世界的な気象データを提供しています。広い地理的カバレッジと頻繁な更新により、OpenWeatherMapは現在の気象と拡張予報の両方が必要なアプリケーションの人気の選択肢です。
  • 提供されるデータ: リアルタイム気温、湿度、風速、空気質、降水確率、その他。現在のデータと予報データの両方を提供します。選定された場所の分単位の気象データを含みます。
  • プロバイダー選択: リクエストの「weather」セクションに「provider = 1」を含めることで、OpenWeatherMapを天気情報プロバイダーとして選択できます。
  • 使用上の注意: 無料プランと有料プランを用意しており、APIキーによる認証を通じてデータにアクセスできます。有料プランでは、高度なデータレイヤーやプレミアム機能をご利用いただけます。
  • One Call API 3.0: UV指数は、One Call API 3.0 を契約しているキー(OpenWeatherMapアカウントでの別契約)でのみ利用できます。このキーでは、現在の天気と予報の個別リクエストの代わりに One Call リクエスト1回で済みます。One Call がキーを拒否した場合は無料の API 2.5 が使用され、1日後に One Call が再試行されます。
  • APIドキュメント: こちらからご利用いただけます。

2. QWeather

  • 説明: QWeather(別名:HeWeather)は、中国を中心とした包括的な気象データを提供するほか、海外のデータも取り扱っています。リアルタイムの天気、予報、大気質情報、警報など、詳細な情報を幅広く提供しています。
  • 提供されるデータ: 現在の気温、湿度、UV指数、大気汚染レベル、日別および時間ごとの予報に加え、悪天候に関する警報も提供しています。詳細な大気質データと、刻々と変化する気象状況のリアルタイム更新で知られています。
  • プロバイダー選択: リクエストの「weather」セクションに「provider = 2」を含めることで、QWeatherを天気情報プロバイダーとして選択できます。
  • 使用上の注意: QWeatherでは、無料プランと有料プランのAPIアクセスが提供されています。無料プランではデータに制限がありますが、有料プランではより多くのデータポイントや地域をカバーできるようになります。
  • APIドキュメント: こちらからご利用いただけます。

3. MET Weather (MET Norway)

  • 説明: ノルウェー気象庁(MET Norway)が提供する「MET Weather API」は、ノルウェーおよび北欧地域に関する予報、過去データ、特定データなど、多様な公開気象データへのアクセスを可能にします。その正確性と透明性で定評のあるMET Weatherは、信頼性の高い気象データを必要とするアプリケーションに最適です。
  • 提供されるデータ: 現在の気象状況、予報、降水量、気温、風速データ、およびUV指数。MET Weatherは北欧地域に特化したデータを提供するほか、世界各国の気象情報にも対応しています。
  • プロバイダー選択: リクエストの「weather」セクションに「provider = 3」を含めることで、気象プロバイダーとしてMET Weatherを選択できます。
  • 使用上の注意: MET Weatherが提供するすべてのデータは、クリエイティブ・コモンズ・ライセンスに基づき、非営利・営利を問わず無料で利用可能です。MET Norwayは環境データの提供で定評があり、特にヨーロッパにおいて信頼されるプロバイダーとなっています。
  • APIドキュメント: こちらからご利用いただけます。

リクエストの例

/source/background.mc
function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // リクエストを送信するために、デバイスがスマートフォンに接続されているかを確認します
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // デバイスに一意の識別子が割り当てられていることを確認します
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // 必要に応じてコードを送信します
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // 必要に応じてNightScoutアプリのURLを送信します
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // 必要に応じて、天気情報のリクエストパラメータを送信します
		var lat = Application.Properties.getValue("latitude");
		var lon = Application.Properties.getValue("longitude");
		if (!lat.equals("") && !lon.equals("")) {
			request.put("weather", {
				"appid" => Application.Properties.getValue("appID"),
				"lat" => lat,
				"lon" => lon,
				"provider" => wP
			});
		}
	}

	if (!request.isEmpty()) {

		// 必要なリクエストパラメータを入力します
		request.put("device", id);
		request.put("app", p2uAppID); // あなたのアプリケーションID
		request.put("model", ds.partNumber);

		Toybox.Communications.makeWebRequest(
			"https://api.p2u.io", // API エンドポイント
			request,
			{
				:method => 3, // Communications.HTTP_REQUEST_METHOD_POST
				:headers => {
					"Content-Type" => 1 // Communications.REQUEST_CONTENT_TYPE_JSON
				},
				:responseType => 0 // Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
			},
			method(:onReceive)
		);
	}
}

APIレスポンス

このAPIは、ロック解除の状態、血糖値、および天気に関する情報を含むJSONオブジェクトを返します。

レスポンスパラメータ

ロック解除コードの確認結果(リクエストが送信された場合):

  • response: 整数 — 戻り値
  • msg: 文字列 — 検証結果に関するメッセージ
  • code: 文字列 — 結果が対象とするロック解除コード(判明している場合)
  • expires: 整数 — コードの有効期限のタイムスタンプ(UNIXTIMESTAMP形式)
  • qr: array — 購入用、またはシリアル番号の確認用のQRコード(該当する場合)

NightScoutアプリの応答(リクエストが送信された場合):

  • bg: 連想配列 — NightScoutアプリからのフォーマット済み応答
    • value: 整数 — 血糖値(mg/dL)
    • date: 整数 — コードの有効期限のタイムスタンプ(UNIXTIMESTAMP形式)
    • direction: 文字列 — 血糖値の変化の傾向

Weather APIのレスポンス(リクエストが送信された場合):

  • weather: 連想配列 — Weather APIからのフォーマット済み応答
    • provider: 整数 — 気象データ提供元の識別子
    • weather: array — 現在の気象状況。1つまたは2つの値が返される場合があります。2つの値が返された場合、それらは昼と夜の気象状況を表します
    • temp: float — 現在の気温(摂氏)
    • feels_like: float — 体感温度(摂氏)
    • pressure: 整数 — 気圧(hPa)
    • humidity: 整数 — 湿度(%)
    • precipitation: 整数 — 降水確率(%)
      MET Weather では北欧諸国のみ。 値が取得できない場合は -1。
    • wind: 整数 — 風向(度)
    • wind_speed: float — 風速(m/s)
    • wind_gust: float — 突風の風速(m/s)
      QWeather では利用できません。 MET Weather では北欧諸国のみ。 値が取得できない場合は -1。
    • uvi: float — UV指数
      OpenWeatherMap では One Call API 3.0 を契約しているキーのみ。QWeather では1日の最大値。MET Weather では晴天時のUV指数。 値が取得できない場合は -1。
    • temp_low: float — 今日の最低気温(摂氏)
    • temp_high: float — 今日の最高気温(摂氏)
    • sunrise_today: 整数 — 今日の日の出時刻(UNIXTIMESTAMP形式)
    • sunset_today: 整数 — 今日の日没時刻(UNIXTIMESTAMP形式)
    • sunrise_tomorrow: 整数 — 明日の日の出時刻(UNIXTIMESTAMP形式)
    • sunset_tomorrow: 整数 — 明日の日没時刻(UNIXTIMESTAMP形式)
    • aqi: 連想配列 — 大気質指数
      • level: 整数 — 大気質指数レベル
      • value: 整数 — 大気質指数の値

レスポンスの例

https://api.p2u.io
{
	"response": 103,
	"msg": "Free for beta tester",
	"expires": 0,
	"qr": [
		"11111110111011010110101111111",
		"10000010111001001101001000001",
		"10111010101100110110101011101",
		"10111010110101000001001011101",
		"10111010000001010100001011101",
		"10000010100110001101001000001",
		"11111110101010101010101111111",
		"00000000010010110111100000000",
		"11001110000100100100100101111",
		"11111100011011011010011111111",
		"01111011100111111100101000001",
		"01111100101100110111011011011",
		"00110110101010100101110000010",
		"11001000010001011000001011111",
		"01101010001001110100000001101",
		"10111101100010100101100110011",
		"01010111111100110100100100010",
		"10000100111011011000101111011",
		"00000110110110110100100000101",
		"00111100011100001100101100011",
		"11110111110010100111111111001",
		"00000000111001011101100010001",
		"11111110010001011111101011101",
		"10000010100010100111100010010",
		"10111010101101100111111111001",
		"10111010010010110000010000001",
		"10111010001111111110000001111",
		"10000010111101011111101101011",
		"11111110100011011110110010010"
	],
	"bg": {
		"value": -102,
		"date": 1730546101,
		"direction": ""
	},
	"weather": {
		"provider": 1,
		"weather": [
			89
		],
		"temp": 0.27,
		"feels_like": -3.14,
		"pressure": 999,
		"humidity": 78,
		"precipitation": 0,
		"wind": 120,
		"wind_speed": 2.96,
		"wind_gust": 5.21,
		"uvi": 0.4,
		"temp_low": -3.8,
		"temp_high": 0.27,
		"sunrise_today": 1730527969,
		"sunset_today": 1730551770,
		"sunrise_tomorrow": 1730614492,
		"sunset_tomorrow": 1730638051,
		"aqi": {
			"level": 1,
			"value": 38
		}
	}
}

レスポンスコード

ロック解除コード検証結果の response フィールドは、次のいずれかの値をとります。レスポンスの例とチェックの順序は API側のチェック で説明しています。

コード 説明
101コードは有効です。アプリケーションのロックを解除できます。
102有効なコードはありませんが、試用期間はまだ終了していません。expires フィールドの日付までアプリケーションのロックを解除できます。
103有効なコードはありませんが、デバイスはベータテスターです。最初の API 呼び出しがアプリケーションの リリース日 フィールドの日付より前に行われました。expires フィールドの日付までアプリケーションのロックを解除できます(0 - 無期限)。
201コードが見つからないか、削除されています。
202コードはすでに別のデバイスで有効化されています。
203コードの有効期限が切れています。
204試用期間が終了し、有効なコードが送信されていません。
301アプリケーションが見つからないか、利用できません。
302コードの期間が定義されていません。
303リクエストのパラメーターが不足しています。
304このアプリケーションではデバイス識別子が必要です。
401コードの保存中にエラーが発生しました。サポート([email protected])までご連絡ください。
402デバイスの保存中にエラーが発生しました。サポート([email protected])までご連絡ください。
500不明なエラーです。サポート([email protected])までご連絡ください。

1xx のコードはアプリケーションのロックを解除できること、2xx はロックしたままにする必要があること、3xx はリクエストのエラー、4xx と 5xx は PayToUse 側のエラーを意味します。4xx と 5xx のエラーの場合は、最後に成功した結果を保持し、後でリクエストを再試行することをお勧めします。

アプリケーションの設定で デバイスIDによるコードの再送信を許可 オプションが有効で、リクエストにデバイス識別子は含まれるがコードは含まれず、このデバイスにすでに有効なコードが紐付けられている場合、API は 101 とともにこのコードを code フィールドで返します。アプリケーションはこれを保存し、ユーザーにコードの入力を求める必要がなくなります。

注釈

  • bg を含むリクエストには、NightScout アプリへの接続が必要です。
  • code を含むリクエストごとに、APIが自動的にコードのステータスを確認し、非アクティブな場合は有効化します。
  • APIのパラメータは、機能性、互換性、およびセキュリティの向上を図るため、随時更新または変更される場合があります。統合や利用に影響を与える可能性のある変更がないか、定期的にAPIドキュメントを確認することをお勧めします。

天気プロバイダー

以下は、weather フィールドで返される天気状態と各プロバイダーの値の対応表です。

Garmin

Garmin SDK気象機能と定数の詳細については、このリンクを参照してください。選択された気象プロバイダーに応じて、APIから取得した値またはGarmin SDKの気象機能の結果を保存して、画面に表示される値の一貫性を確保することができます。

ID 説明 日 夜
0 晴天
0x53

0x54
40 晴れ
23 概ね晴れ
0x55

0x56
1 ところどころ曇り
0x57

0x58
22 所々晴れ
2 ほぼ曇り
0x59
52 薄い雲
20 曇り
0x5A
45 曇り、雨の可能性
31 霧雨
0x3E
14 小雨
0x42
24 弱いにわか雨
3 雨
0x43
25 にわか雨
27 にわか雨の可能性
0x46
11 所によりにわか雨
15 大雨
26 強いにわか雨
28 雷雨の恐れ
0x36

0x37
12 所により雷を伴う雨が降る
0x38
6 雷雨
0x39
8 霧
0x4E
9 かすみ
29 もや
39 煙霧
30 ほこり
0x4F
35 砂
33 煙
38 火山灰
37 砂嵐
13 種類不明の降水
5 強風
0x52
36 スコール
48 にわか雪
32 竜巻
0x50
41 ハリケーン
42 熱帯暴風雨
50 凍雨
0x45
7 冬の混合降水
18 弱いみぞれ
19 強いみぞれ
21 みぞれ
49 着氷性の雨
44 みぞれの可能性
47 曇り、みぞれの可能性
34 氷
51 氷と雪
43 雪の可能性
0x4C

0x4D
16 小雪
46 曇り、雪の可能性
0x4A
4 雪
17 大雪
0x4B
10 雹
0x3A

Open Weather Map

例として、こちらのOpenWeatherMap用アイコンセットをご覧ください。

ID 説明 日 夜
2xx 雷雨
200 小雨を伴う雷雨
0x36

0x37
201 雨を伴う雷雨
0x38
202 激しい雨を伴う雷雨
210 弱い雷雨
211 雷雨
0x39
212 激しい雷雨
0x3B
221 不規則な雷雨
230 弱い霧雨を伴う雷雨
0x3A
231 霧雨を伴う雷雨
232 激しい霧雨を伴う雷雨
3xx 霧雨
300 弱い霧雨
0x3C

0x3D
301 霧雨
0x3E
302 激しい霧雨
0x3F
310 弱い霧雨と雨
0x40
311 霧雨と雨
312 強い霧雨と雨
0x41
313 にわか雨や霧雨
314 激しいにわか雨と霧雨
321 にわか霧雨
5xx 雨
500 小雨
0x42
501 並の雨
0x43
502 激しい雨
0x44
503 非常に激しい雨
504 豪雨
511 着氷性の雨
0x45
520 弱いにわか雨
0x46
521 にわか雨
522 激しいにわか雨
531 不規則なにわか雨
6xx 雪
600 小雪
0x4C

0x4D
601 雪
0x4A
602 大雪
611 凍雨
0x45
612 弱いにわかみぞれ
613 にわかみぞれ
615 弱い雨と雪
616 雨と雪
620 弱いにわか雪
0x4B
621 にわか雪
622 強いにわか雪
7xx 大気現象
701 もや
0x4E
711 煙
0x4F
721 煙霧
731 砂塵の渦
741 霧
751 砂
0x4F
761 ほこり
762 火山灰
771 スコール
0x52
781 竜巻
0x50
800 晴天
800 晴天
0x53

0x54
80x 雲
801 雲が少ない 11~25%
0x55

0x56
802 散在する雲 25~50%
0x57

0x58
803 雲が多い 51~84%
0x59
804 曇り 85~100%
0x5A

QWeather

こちらのリンクをクリックすると、オリジナルの天気アイコンセットをご覧いただけます

ID 説明 日 夜
302 雷を伴うにわか雨
0x36

0x37
303 激しい雷雨
0x38
310 豪雨
0x39
317 豪雨から激しい豪雨
304 雹
0x3A
311 激しい豪雨
0x3B
312 猛烈な豪雨
318 激しい豪雨から猛烈な豪雨
309 霧雨
0x3C

0x3D
404 凍雨
0x3E
305 小雨
0x42
314 小雨から並の雨
306 並の雨
0x43
315 並の雨から強い雨
399 雨
308 猛烈な雨
0x44
316 強い雨から豪雨
313 凍雨
0x45
405 雨と雪
300 にわか雨
0x46
301 強いにわか雨
307 強い雨
350 にわか雨
351 強いにわか雨
400 小雪
0x4C

0x4D
408 小雪から中雪
499 雪
401 並の雪
0x4A
402 大雪
409 並の雪から大雪
410 大雪から吹雪へ
403 吹雪
0x4B
406 にわか雨と雪
407 にわか雪
456 にわか雨と雪
457 にわか雪
503 砂
0x4E
504 ほこり
507 砂嵐
508 砂嵐
511 中程度のもや
512 濃いもや
513 非常に濃いもや
500 もや
0x4F
501 霧
502 煙霧
509 濃霧
510 強い霧
514 非常に濃い霧
515 極めて濃い霧
100 晴れ
0x53

0x54
150 晴天
101 曇り
0x55

0x56
151 曇り
102 雲が少ない
0x57

0x58
152 雲が少ない
103 晴れ時々曇り
0x59
153 晴れ時々曇り
104 曇り
0x5A

MET Weather

例として、こちらのMET Weather用アイコンセットをご覧ください。

ID 説明 日 夜
lightrainshowers 弱いにわか雨
0x36

0x37
lightrainshowersandthunder 弱いにわか雨と雷
rainshowersandthunder にわか雨と雷
heavyrainshowersandthunder 強いにわか雨と雷
heavyrainandthunder 強い雨と雷
0x38
rainandthunder 雨と雷
lightrainandthunder 弱い雨と雷
0x39
heavysleetandthunder 強いみぞれと雷
0x3B
lightsleetandthunder 弱いみぞれと雷
0x3A
lightssleetshowersandthunder 弱いにわかみぞれと雷
sleetandthunder みぞれと雷
lightsleetshowers 弱いにわかみぞれ
0x3C

0x3D
sleetshowers にわかみぞれ
sleetshowersandthunder にわかみぞれと雷
heavysleetshowers 強いにわかみぞれ
heavysleetshowersandthunder 強いにわかみぞれと雷
lightsleet 弱いみぞれ
0x3E
sleet 凍雨
0x3F
heavysleet 強いみぞれ
0x45
lightrain 小雨
0x42
rain 雨
0x43
heavyrain 大雨
0x44
rainshowers にわか雨
0x46
heavyrainshowers 強いにわか雨
heavysnow 大雪
0x4B
heavysnowandthunder 強い雪と雷
snow 雪
snowandthunder 雪と雷
lightsnowshowers 弱いにわか雪
0x4C

0x4D
lightssnowshowersandthunder 弱いにわか雪と雷
snowshowers にわか雪
snowshowersandthunder にわか雪と雷
heavysnowshowers 強いにわか雪
heavysnowshowersandthunder 強いにわか雪と雷
lightsnow 小雪
0x4A
lightsnowandthunder 弱い雪と雷
fog 霧
0x4F
clearsky 晴天
0x53

0x54
fair 晴れ
0x55

0x56
partlycloudy ところどころ曇り
0x57

0x58
cloudy 曇り
0x59