ガイド
カメラプレビューを使用する方法はCapacitor
@capgo/camera-preview を使用
カメラ プレビュー プラグインの主なインターフェイス
インストール
bun add @capgo/camera-preview
bunx cap sync
bunx cap sync Capacitorカメラプレビューのプラグインのネイティブcodeをあなたのネイティブプロジェクトにコピーします。プラグインのアップグレード後は、再度実行してください。
インポート
import { CameraPreview } from '@capgo/camera-preview';
APIの概要
| メソッド | 説明 |
|---|---|
start |
カメラプレビューを開始します。 |
stop |
カメラプレビューを停止します。 |
capture |
カメラから写真をキャプチャします。 |
captureSample |
カメラプレビューのストリームから1枚のフレームをキャプチャします。 |
startBarcodeScanner |
アクティブなカメラプレビューでバーコードスキャンを開始します。 |
stopBarcodeScanner |
バーコードスキャンを停止し、カメラプレビューを継続します。 |
getSupportedFlashModes |
アクティブなカメラでサポートされているフラッシュモードを取得します。 |
setAspectRatio |
カメラプレビューのアスペクト比を設定します。 |
getAspectRatio |
カメラプレビューの現在のアスペクト比を取得します。 |
setGridMode |
カメラプレビューのオーバーレイのグリッドモードを設定します。 |
getGridMode |
カメラプレビューのオーバーレイの現在のグリッドモードを取得します。 |
checkPermissions |
カメラ (およびオプションでマイク) の許可状態を確認します。システムダイアログを提示せずに。 |
requestPermissions |
カメラ (およびオプションでマイク) の許可を要求します。許可が既に付与されたり拒否されたりしている場合は、現在の状態が提示されます。 showSettingsAlert true の場合、許可が拒否されている場合、プラットフォーム固有のアラートが提示されます。ユーザーをアプリの設定に案内します。 |
getHorizontalFov |
アクティブなカメラの水平視野角度 (FoV) を取得します。注: 一部のデバイスでは、推定値になります。 |
getSupportedPictureSizes |
すべてのカメラでサポートされているピクチャサイズを取得します。 |
setFlashMode |
アクティブなカメラのフラッシュモードを設定します。 |
flip |
前面カメラと後面カメラを切り替えます。 |
setOpacity |
カメラプレビューの不透明度を設定します。 |
stopRecordVideo |
動画の撮影を停止します。 |
startRecordVideo |
動画の撮影を開始します。 |
setVideoQuality |
現在のカメラセッションで動画の撮影品質を設定します。 |
getVideoQuality |
現在の動画の撮影品質を取得します。 |
getSupportedVideoQualities |
現在のカメラでサポートされている動画の撮影品質を取得します。 |
setVideoCodec |
録画時に使用する動画のエンコード方式を設定します。 |
getVideoCodec |
現在の録画に使用する動画のエンコード方式を取得します。 |
getSupportedVideoCodecs |
現在のカメラでサポートされている動画のエンコード方式を取得します。 |
isVideoStabilizationSupported |
現在のカメラで動画の安定化機能がサポートされているかどうかを確認します。 |
getSupportedVideoStabilizationModes |
現在のカメラでサポートされている動画の安定化モードを取得します。 |
getVideoStabilizationMode |
現在の動画の安定化モードを取得します。 |
setVideoStabilizationMode |
録画時に使用する動画の安定化モードを設定します。録画中の場合に変更することはできません。 videoStabilizationMode in startRecordVideo() options. |
isRunning |
カメラプレビューが現在実行中かどうかを確認します。 |
getAvailableDevices |
利用可能なすべてのカメラデバイスを取得します。 |
getZoom |
現在のズーム状態、最小値/最大値、および現在のレンズ情報を取得します。 |
getZoomButtonValues |
ズームボタンの値を取得します。 - iOS/Android: 超広角が利用可能な場合は 0.5 を含みます。広角が利用可能な場合は 1 と 2 を含みます。望遠レンズが利用可能な場合は 3 を含みます。 - Web: 不対応。 |
setZoom |
カメラのズームレベルを設定します。 |
getFlashMode |
現在のフラッシュモードを取得します。 |
setDeviceId |
指定されたカメラに切り替えます。 deviceId. |
getDeviceId |
現在バインドされているカメラデバイスのIDを取得します。Androidの場合、物理レンズの要求が論理カメラにフォールバックした場合、このIDは論理カメラのIDを返します。 |
getPreviewSize |
現在のプレビューのサイズと位置を取得します。 |
setPreviewSize |
プレビューのサイズと位置を設定します。 |
setFocus |
カメラのプレビューで特定のポイントに焦点を設定します。 |
deleteFile |
指定された絶対パスにあるデバイス上のファイルを削除します。 これを使用して、Capacitor Camera Previewで作成された一時的な画像を迅速にクリーンアップできます。 storeToFileウェブ上ではサポートされていません。エラーが発生します。 |
getSafeAreaInsets |
安全なエリアのインセットを取得します。 オリエンテーションに応じたノッチ/カメラカットアウトのインセットと現在のオリエンテーションを返します。 ポートレートモードでは、上部のインセット (ノッチが上部にあります) を返します。 ランドスケープモードでは、左側のインセット (ノッチが側面に移動します) を返します。 これは、すべてのモダンな電話で使用されているカットアウトエリア (ノッチ、パンチホールなど) を特定的にターゲットします。 |
getOrientation |
現在のデバイスのオリエンテーションをクロスプラットフォーム形式で取得します。 |
getExposureModes |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 |
getExposureMode |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 |
setExposureMode |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 |
getExposureCompensationRange |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 |
getExposureCompensation |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 |
setExposureCompensation |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 |
getWhiteBalanceModes |
アクティブなカメラでサポートされている安全なエリアのインセットを取得します。 CUSTOM 実装されていない場合、手動でサポートが実装されるまでリストされません。 |
getWhiteBalanceMode |
現在の白色バランスモードを返します。 |
setWhiteBalanceMode |
白色バランスモードを設定します。 CONTINUOUS 自動白色バランスを実行し続ける (推奨; 黄色/暖色のキャストを避ける)、 LOCK 現在のゲインを固定します。 AUTO 1回の調整を実行します。 CUSTOM 実装されていない場合、手動でサポートが実装されるまで予約されます。 |
getSupportedVideoFrameRates |
現在のフォーマットで使用可能な動画フレームレートをリストします。サポートされる値は、選択したカメラ、レンズ、および動画品質によって異なります。 |
getVideoFrameRate |
現在のカメラで構成された動画フレームレートを返します。Androidでは、低光量や熱圧力下では実際の記録フレームレートが変化する可能性があります。 |
setVideoFrameRate |
アクティブなカメラセッションのターゲット動画フレームレートを設定します。開始時には frameRate to startRecordVideo() 開始時には |
サンプル
start()
__CAPGO_KEEP_0__
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.start({ parent: 'parent' });
console.log(result);
stop()
カメラプレビューを開始します。
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stop();
capture()
カメラプレビューを停止します。
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.capture({ height: 1920 });
console.log(result);
captureSample()
カメラから写真を撮ります。
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.captureSample({
quality: 85,
mirrorFrontCamera: false,
});
console.log(result);
startBarcodeScanner()
カメラプレビューのストリームから1枚のフレームを撮ります。
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.startBarcodeScanner();
stopBarcodeScanner()
アクティブなカメラプレビューでバーコードスキャンを開始します。
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stopBarcodeScanner();
バーコードスキャンを停止し、カメラプレビューを続行します。 GitHub リポジトリ.
__CAPGO_KEEP_0__
addListener イベントをリスンする handle.remove() ハンドルを返します。画面がアンマウントされたときに呼び出してください。 CameraPreview.removeAllListeners() リスナーをすべてクリアします。
フルリファレンス
使用中の@capgo/camera-previewから続けてください
使用中の 使用中の@capgo/camera-preview プランするnativeメディアとインターフェイスの動作を、@__CAPGO_KEEP_0__/camera-previewと接続します。 @capgo/camera-previewと接続します。 実装詳細は@capgo/camera-previewにあります。 はじめに Capacitorカメラプレビュー @capgo/capacitorライブイベントを使用 native機能のために@capgo/capacitor-live-activitiesを使用します。 @capgo/capacitor-ライブ活動 @capgo/capacitor-ライブアクティビティの実装詳細について Using @capgo/capacitor-video-player Capacitor-カメラプレビューのnative機能のために@capgo/capacitor-ビデオプレーヤーを使用します。