Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
Vegaターボモジュールは、ターボモジュールのパラメーターと戻り値で、JavaScriptと相互に変換できるさまざまなネイティブ型をサポートしています。これは、たとえば、std::stringを受け取るTurbo ModuleメソッドはJavaScript文字列を使用してJavaScriptから呼び出すことができ、引数は自動的に変換されることを意味します。同様に、std::stringを返すTurbo ModuleメソッドはJavaScript環境にJavaScript文字列を返します。std::stringやint32_tなど、これらの一部は基本的な C++ タイプです。その他はVega固有のもので、主にcom::amazon::kepler::turbomodule名前空間の一部として利用できます。

型マップ

次の表は、TypeScript型とそれに対応するC++型とのマッピングを示しています。これはcodegenツールで使用されるマッピングです。 これらのタイプの中には、基本TypeScriptの一部ではないため、@amazon-devices/keplerscript-turbomodule-apiからインポートする必要があるものもあります。 [1]int64_tはNumber.MAX_SAFE_INTEGERが原因で精度が失われる可能性があります。精度が必要な大きな整数には、BigIntを使用できます。 [2] 同種配列とは、要素の型が同じ配列です。 [3]BigIntは符号付きおよび符号なし64ビット整数のメソッドパラメーターおよび戻り値の型として直接サポートされています。サポートされている使用方法の詳細については、BigIntを参照してください [4] JsonContainerは、JSObjectの欠陥が解消された後、削除される予定です。使用する必要がある場合は、JsonContainer型を@amazon-devices/keplerscript-turbomodule-apiからジェネリックなObjectとしてインポートするか、次のようなカスタム型エイリアスを定義できます。
注: JavaScriptのNumber.MAX_SAFE_INTEGERよりも大きい整数の場合は、ターボモジュールのパラメーターと戻り値の型として、std::string表現を使用してください。JavaScriptおよびC++の実装では、stringをより適切な型に変換できます。

JSArray

同種(T[])配列の場合は、を使用できます。その他の配列には、JSArrayを使用できます。 JSArrayはstd::vectorで、nullポインター、ブール値、各種のint、double、float、std::string、JSArray、JSObjectなど、さまざまな型の要素を受け入れます。したがって、その使用法はstd::vectorと同様です。 例

JSObject

JSObjectは、std::stringキーを持つstd::mapで、nullポインター、ブール値、各種int、double、float、std::string、JSArray、JSObjectなど、さまざまな型の値を受け入れます。したがって、その使用法はstd::mapと同様です。 JSObjectは静的parseJsonメソッドを提供します。このparseJsonメソッドは std::stringJSON文字列を受け入れ、同等のJSObjectを返します。 例

プロキシJSObjectとJSArray

Vega ターボモジュール、プロキシタイプだけでなくproxy::JSObject、proxy::JSArrayおよびタイプもサポートしています。JSObject JSArrayプロキシ型の主な機能の1つは、動的なアクセスと変更です。コピーを作成しなくても、C++コードからJavaScriptオブジェクトや配列の読み取りと書き込みを直接行うことができます。 ただし、これらのプロキシ型を使用する際に留意すべき重要な点がいくつかあります。
  • Threadに関する考慮事項: プロキシ型はJSThreadコンテキストとターボモジュールメソッド呼び出しの範囲内で使用する必要があります。これらを保存したり、任意のThreadからアクセスしたりすることはできません。Threadの安全性チェックはデバッグモードでのみ実行されるため、マルチスレッド環境でこれらのプロキシオブジェクトを操作する場合は注意が必要です。
  • ネイティブでの構築 新しいプロキシ項目はネイティブに構築することができます。ただし、必要なJSRuntimeをターボモジュール、またはHostCallbackメソッドからメソッドパラメーターとして取得する必要があります。 警告: デフォルトコンストラクタは使用しないでください。これらのプロキシ型のデフォルトコンストラクタはstd::tupleおよびstd::variantなどの構造体での現在の内部使用をサポートするためにのみ維持されています。これらのデフォルトコンストラクタには依存しないでください。JSThreadコンテキストを必要とするため、将来のリリースでは削除される予定です。

JSRuntime

JSRuntime型はJavaScriptランタイム環境を表します。これはネイティブ専用の型で、任意のターボモジュールまたはHostCallbackメソッドによってパラメーターとしてリクエストできます。これは通常、C++で新しいプロキシ項目を作成するために使用されます。 注:JSRuntimeはJSThread以外からは構築できません。

proxy::JSObject

proxy::JSObject型を使用すると、ネイティブコードに渡すことができるJavaScriptオブジェクトを作成し、コピーを作成せずにネイティブ側からそのプロパティとメソッドに動的にアクセスして変更できます。 注: proxy::JSObjectへのアクセスはJSThreadコンテキストに制限されており、Turbo Module メソッドの呼び出しスコープ内で行う必要があります。Threadの安全性チェックはデバッグモードでのみ実行されます。

proxy::JSArray

proxy::JSArray型を使用すると、ネイティブコードに渡すことができるJavaScript配列を作成し、その要素にネイティブ側から動的にアクセスして変更できます。 注: proxy::JSArrayへのアクセスはJSThreadコンテキストに制限されており、Turbo Module メソッドの呼び出しスコープ内で行う必要があります。Threadの安全性チェックはデバッグモードでのみ実行されます。

Promise

Promiseは別のスレッドで実行する必要があります。 PromiseはPromiseOperationを入力として構成されます。PromiseOperationは を受け入れてvoidを返す関数です。 Promiseにはresolve rejectメソッドがあります。Promiseは、Errorまたはstd::stringを使用して拒否でき、types mapに示されているC++ Turbo Module型のいずれかを使用して解決できます。 例

Callback

コールバックは別のスレッドで実行する必要があります。 Callbackオブジェクトは、パラメーター値としてのみ使用でき、C++に渡されるJavaScriptコールバックを表します。戻り値の型としてのコールバックについては、HostCallbackを参照してください。 Callbackオブジェクトが公開する唯一のメソッドはinvokeです。このメソッドは、指定された引数でJavaScriptコールバックを呼び出し、その結果をC++に返します。 例

HostCallback

HostCallbackは戻り値としてのみ使用でき、JavaScript環境にC++コールバックを返すために使用されます。パラメータタイプとしてのコールバックについては、Callbackを参照してください。 例
HostCallbackを使用してCallbackを呼び出すこともできます。

ArrayBuffer

ArrayBufferは汎用の固定長生バイナリデータバッファーを表します。 例

BigInt

BigIntは整数を表します。JavaScript では、これらはNumber.MAX_SAFE_INTEGERまたはNumber.MIN_SAFE_INTEGERを超える整数に使用されます。Vegaでは、ターボモジュールは、int64_tを持つBigInt、ベースのゲッターメソッドとコンストラクターメソッドを持つuint64_tをサポートしています。
メソッドのパラメーターや戻り値、コールバックやPromiseにはBigIntを使用できますが、未加工の値としてのみ使用できJSArrayまたはJSObjectの一部としては使用できません。 JavaScriptのBigIntが大きすぎてVega Turbo ModuleのBigInt型では表現できない場合(たとえばint64_tまたはuint64_tでは表現できない場合)、Vega Turbo Modulesのすべての無効なパラメーターと同様に、アサーションに失敗します。詳細については、「ターボモジュールに関する高度なトピック」のエラー処理を参照してください。

utils::json::JsonContainer

JSObjectタイプのJsonContainerは置き換えられていますが、現時点ではまだいくつかの機能にギャップがあります。サポートされている型の完全なリストについては、型マップを参照してください。 例

NativeObject

ネイティブコードからJavaScriptにデータを渡すときに、ほとんどの場合、JSONContainerまたはJSObjectで十分です。ただし、JavaScriptからメソッドを呼び出すことができるネイティブオブジェクトが必要な場合は、com::amazon::kepler::turbomodule::NativeObjectを実装するオブジェクトを作成する必要があります。 例
NativeObjectはターボモジュールメソッドの戻り値の型としてのみサポートされており、パラメーターとしてはサポートされていないことに注意してください。

APMF型

IDLは一部のAPMF型を使用しますが、サポートされているターボモジュールのパラメーターや戻り値の型との間で直接変換できない場合があります。これらの変換を行うには、カスタムロジックの実装が必要になる場合があります。

関連トピック

ターボモジュールの作成
最終更新日 2025年9月30日