ウェブカメラ設定のソースを表示

[[Category:イメージング]]
[[Category:入力デバイス‏‎]]
[[en:Webcam setup]]
[[es:Webcam setup]]
こちらは Arch Linux でウェブカメラを設定するガイドです。

ほとんどの場合、ウェブカメラは何も設定しなくても動作します。ビデオデバイス (例えば {{ic|/dev/video0}}) へのアクセスの許可は [[udev]] により管理されており、追加の設定は必要ありません。

== ロード ==

最近のほとんどのウェブカメラは UVC (''USB Video Class'') に対応しており、汎用の ''uvcvideo'' カーネルドライバモジュールによりサポートされています。あなたのウェブカメラが認識されているかどうか確かめるには、ウェブカメラを接続した直後に [[dmesg]] を実行してください。以下と似たようなものが出力されるはずです:

{{hc|# dmesg {{!}} tail|
sn9c102: V4L2 driver for SN9C10x PC Camera Controllers v1:1.24a
usb 1-1: SN9C10[12] PC Camera Controller detected (vid/pid 0x0C45/0x600D)
usb 1-1: PAS106B image sensor detected
usb 1-1: Initialization succeeded
usb 1-1: V4L2 device registered as /dev/video0
usb 1-1: Optional device control through 'sysfs' interface ready
usbcore: registered new driver sn9c102}}
UVC 以前のウェブカメラの中には、''gspca'' カーネルドライバモジュールによってサポートされているものもあります。このフレームワークでサポートされているデバイスの完全ではないリストは [https://docs.kernel.org/admin-guide/media/gspca-cardlist.html gspca cards list] を見てください。

あなたのウェブカメラがカーネルのドライバによってサポートされていない場合、外部のドライバが必要となります。まず、ウェブカメラの名前を調べます ({{ic|lsusb}} などを使って)。次に、ウェブカメラに関する情報やリソースが載っている [https://www.linuxtv.org/wiki/index.php/Webcam_devices webcam devices] を見ます。あなたのウェブカメラと互換性のあるドライバを見つけたら、それに対応する[[カーネルモジュール]]を {{ic|/etc/modules-load.d/webcam.conf}} に追加する必要があります。これで、ブートの init ステージでドライバがカーネルにロードされるようになります。

{{Note|ウェブカメラを操作するために使用される、Linux カーネルからユーザスペースへの API は、''Video4Linux2'' 略して '''v4l2''' という名前です。v4l2 に対応しているアプリケーションは全て、カーネルのドライバで動作します。}}

== Linux のウェブカメラサポート ==

ほとんどの場合ウェブカメラは何も設定しなくても動作します。その場合、色調や明るさなどのパラメータを設定したいなら、[[#ウェブカメラ設定|ウェブカメラ設定]]のセクションまでスキップできます。ウェブカメラが自動で動作しない場合は以下の手順に従って下さい。

== ウェブカメラを確認する ==

({{Ic|lsusb}} などを使って) ウェブカメラの名前を確認して適切なドライバーを探して下さい。以下はウェブカメラと、ウェブカメラが動作するドライバーのリストです。モジュールのコンパイルに関する情報などはデバイスの名前の右のリンクをクリックしてください。ウェブカメラを動作させることができたら、このリストにあなたの使ったドライバーとウェブカメラの名前を追加してください！

=== pwc ===

* Creative Labs Webcam Pro Ex
* Logitech QuickCam Notebook Pro ("Pro" モデルのみ)
* Logitech Quickcam Pro 4000
* Philips ToUCams (未確認)
* Philips SPC900NC

=== qc-usb ===

* Dexxa Webcam
* Labtec Webcam (旧モデル) 
* LegoCam
* Logitech Quickcam Express (旧モデル)
* Logitech QuickCam Notebook ("Pro" モデルは含まず)
* Logitech Quickcam Web

=== qc-usb-messenger ===

* Logitech Quickcam Messenger
* Logitech Quickcam Communicate (Communicate MP/S5500 や "for Business" については下の linux-uvc セクションを参照)

{{Note|現在このドライバーはカーネル 2.6.27 に含まれているモジュールです。}}

=== zr364xx ===

このドライバーは多数のウェブカメラで使用できます:
* Aiptek PocketDV 3300
* Creative PC-CAM 880
* Konica Revio 2
* Genius Digital Camera
* Maxell Maxcam PRO DV3
サポートされているデバイスの完全なリストは [http://royale.zerezo.com/zr364xx/ こちら] で見れます。

=== sn9c102 ===

* Trust Spacecam シリーズ
* Maxell Smartcam (ノートパソコン用): 最大解像度 352x288 @ 3fps

=== gspca ===

サポートされているウェブカメラの完全なリストは [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/video4linux/gspca.txt;hb=HEAD こちら] です。

{{Note|このドライバーは V4L1 をサポートしていません。}}

=== stv680 ===

ここ数年アジアで作られた安いノーブランドのカメラはほとんど stv680 チップセットを使っています。こういったカメラは多くがノベルティグッズです (Pencam, SpyC@m, LegoCam)。
* Aiptek PenCam シリーズ
* Digitaldream シリーズ
* Dolphin Peripherals シリーズ
* Lego LegoCam
* Trust SpyC@m シリーズ
* Welback Coolcam

stv680 チップセットを使用するウェブカメラの完全なリストは [http://webcam-osx.sourceforge.net/cameras/index.php?orderBy=controller こちら] から見れます。

=== linux-uvc ===

* Genius iLook 1321
* Logitech  Webcam C210
* Logitech   Webcam C250
* Logitech   Webcam C270
* Logitech   Webcam C600
* Logitech HD Webcam C525
* Logitech HD Pro Webcam C920
* Logitech Quickcam Pro 5000
* Logitech Quickcam Pro 9000
* Logitech Quickcam Orbit AF
* Logitech Quickcam Orbit MP
* Logitech Quickcam S5500
* Microdia Pavilion Webcam (on MSI PR200)
* Logitech Quickcam Communicate MP/S5500 または "for Business"
* Chicony Electronics CNF7051
* Lite-On USB ウェブカメラ

サポートされている UVC デバイスの完全なリストは [http://www.ideasonboard.org/uvc/ こちら] で見れます。

カーネル 2.6.26 から linux-uvc はカーネルに含まれています。uvcvideo モジュールをロードしてください。

{{Note|
* このドライバーは V4L1 をサポートしていません。
* WebCam SCB-0385N (usb ID 2232:1005), WebCam SC-0311139N (usb ID 2232:1020), WebCam SC-03FFL11939N (usb ID 2232:1028) では、カメラの使用によってシステムがフリーズする場合、モジュールの設定を追加する必要があります:
 {{hc|1=/etc/modprobe.d/uvcvideo.conf|2=options uvcvideo nodrop=1}} }}

=== ov51x-jpeg ===

* Sony EyeToy
* Chicony DC-2120 
* Chicony DC-2120 pro
* Trust Spacecam 320
* Hercules Webcam Deluxe 	
* Hercules Webcam Classic 
* Creative Live! Cam Notebook Pro VF0400 
* Creative Live! Cam Vista IM 	
* Creative Live! Cam Vista IM VF0420 
* Creative Vista Webcam VF0330 
* ASUS webcam Model? 	
* Philips PCVC820K/00 
* NGS showtime plus 
* HP VGA Webcam with Integrated Microphone

"Creative Live! Cam Vista IM" を Skype で使うには、次の行を {{ic|/etc/modprobe.d/modprobe.conf}} に追加する必要があります:
 options ov51x-jpeg forceblock=1

=== r5u870 (Ricoh) ===

* HP Pavilion Webcam
* HP Webcam 1000
* Sony VAIO VGP-VCCx

Ricoh ウェブカメラは新しい Sony のノートパソコンでよく使われています。

{{AUR|r5u87x-hg}}{{Broken package link|{{aur-mirror|r5u87x-hg}}}} (ファームウェアも入っています) をインストールして {{ic|r5u87x-loader}} コマンドを実行してください。

=== stk11xx (Syntek) ===

* Asus のノートパソコンに搭載された内蔵カメラ
* Asus A8J, F3S, F5R, F5GL, F9E, VX2S, V1S, A6T

{{AUR|stk11xx-svn}} パッケージをインストールしてください。適切なカーネルモジュールが含まれています。

== ウェブカメラのモジュールがロードされているか確認する ==

あなたの使っているウェブカメラの[[カーネルモジュール#ロード|モジュール]]を {{ic|/etc/modules-load.d/webcam.conf}} に追加すればブートストラップの初期化段階でカーネルにロードされるようになります。

ウェブカメラが USB の場合、カーネルは自動的に適切なドライバーをロードする''はず''です。この場合、ウェブカメラを接続して dmesg を確認してください。以下のような表示があるはずです:

{{hc|<nowiki>$ dmesg|tail</nowiki>|<nowiki>
sn9c102: V4L2 driver for SN9C10x PC Camera Controllers v1:1.24a
usb 1-1: SN9C10[12] PC Camera Controller detected (vid/pid 0x0C45/0x600D)
usb 1-1: PAS106B image sensor detected
usb 1-1: Initialization succeeded
usb 1-1: V4L2 device registered as /dev/video0
usb 1-1: Optional device control through 'sysfs' interface ready
usbcore: registered new driver sn9c102
</nowiki>}}

== パーミッション ==

ビデオデバイス (例: {{ic|/dev/video0}}) にアクセスするパーミッションは [[udev]] によって管理されるので、設定は必要ありません。

== ウェブカメラ設定 ==

明るさや色調などのウェブカメラのパラメータを設定したい場合 (例: デフォルトの色調が青・赤・緑みがかっているなど)、[[公式リポジトリ]]に {{Pkg|guvcview}} パッケージとして存在する [http://guvcview.sourceforge.net/ GTK+ UVC Viewer] (guvcview) を使うことができます。インストールして起動すれば、調整できる設定のリストが表示されます。設定を変更すると全てのアプリケーションに影響があります (例: Skype)。

=== ウェブカメラの解像度 ===

まずは[[#ウェブカメラを確認する|ウェブカメラを確認]]してください:
{{hc|$ lsusb|
Bus 001 Device 002: ID 5986:0241 Acer, Inc BisonCam, NB Pro
...
}}

そして、{{ic|Bus}} と {{ic|Device}} 番号を使ってデバイスに関する詳細な情報を取得:

{{hc|<nowiki>$ lsusb -s 001:002 -v | egrep "Width|Height"</nowiki>|
wWidth    640
wHeight   480
wWidth    1280
wHeight   1024
...
}}

出力を見ることで、カメラの縦・横の解像度がわかります。上記の場合、1280x1024 に加えて小さな解像度が利用できます [https://askubuntu.com/questions/214977/how-can-i-find-out-the-supported-webcam-resolutions/214990#214990]。

== アプリケーション ==

[[アプリケーション一覧/マルチメディア#ウェブカメラ]] も見てください。

=== xawtv ===

ベーシックな ''Video4Linux2'' デバイスビュアーです。TV チューナーカードで使うことが想定されていますが、ウェブカメラでも問題なく動作します。ウィンドウにウェブカメラの映像を表示します。

{{AUR|xawtv}} を[[インストール]]し、以下のコマンドで実行してください:
 $ xawtv -c /dev/video0

エラーが発生する場合は、[[#xawtv と nvidia カード]] を見てください。

=== VLC ===

[[VLC]] を使ってウェブカメラを表示したり記録することもできます。VLC の「メディア」ニューから「キャプチャーデバイスを開く」ダイアログを開いて、ビデオとオーディオのデバイスファイルを入力してください。もしくはコマンドラインから次を実行してください:
 $ vlc v4l2://:input-slave=alsa://:v4l-vdev="/dev/video0"
これで VLC はウェブカメラのミラーを作ります。
* 写真を撮影するには、''Video'' メニューの ''Snapshot'' を選択してください。
* 動画を記録するには、{{ic|--sout}} 引数を追加します、例:
 $ vlc v4l://:v4l-vdev="/dev/video0":v4l-adev="/dev/audio2" --sout "#transcode{vcodec=mp1v,vb=1024,scale=1,acodec=mpga,ab=192,channels=2}:duplicate{dst=std{access=file,mux=mpeg1,dst=/tmp/test.mpg}}"

(明らかにこのビットレートは大げさですが、テスト目的であれば問題ありません)。デフォルトではビデオを表示しないことに注意してください。録画中のものを見るには、引数に表示先のディスプレイを追加する必要があります (ハードウェアの負担は増えます):
 ... :duplicate{'''dst=display''',dst=std{access= ....

VLC がウェブカメラを検出しない場合は、{{Pkg|zvbi}} パッケージがインストールされていることを確認してください。

=== MPlayer ===

[[MPlayer]] を使ってウェブカメラのスナップショットを撮るには、ターミナルから次のコマンドを実行します:
 $ mplayer tv:// -tv driver=v4l2:width=640:height=480:device=/dev/video0 -fps 15 -vf screenshot
ここから {{ic|s}} を押すことでスナップショットが作られます。スナップショットはあなたのカレントフォルダに {{ic|shotXXXX.png}} と保存されます。
連続動画を記録したい場合:
 $ mencoder tv:// -tv driver=v4l2:width=640:height=480:device=/dev/video0:forceaudio:adevice=/dev/dsp -ovc lavc -oac mp3lame -lameopts cbr:br=64:mode=3 -o ''filename''.avi
{{ic|Ctrl+c}} を押せば録画が終了します。

デフォルト (ほとんどの場合 YUYV) の代わりに MJPEG をピクセル形式として使って [[MPlayer]] で動画を再生するには、以下を実行することで可能です:
 $ mplayer tv:// -tv driver=v4l2:width=640:height=480:device=/dev/video0:outfmt=mjpeg -fps 15

=== mpv ===

[[mpv]] を使ってウェブカメラの画像を取得するにはターミナルから以下のコマンドを実行:
 $ mpv av://v4l2:/dev/video0 --profile=low-latency --untimed

{{ic|s}} を押すことでスナップショットが取得されます。スナップショットはカレントフォルダに {{ic|mpv-shot''NNNN''.jpg}} という名前で保存されます。

デフォルト (ほとんどの場合 YUYV) の代わりに MJPEG をピクセル形式として使って [[MPlayer]] で動画を再生するには、以下を実行することで可能です:
 $ mpv --demuxer-lavf-format=video4linux2 --demuxer-lavf-o-set=input_format=mjpeg av://v4l2:/dev/video0

こうすることで、品質とパフォーマンスが劇的に向上することがあります (例えば 5FPS -> 30FPS)。

ウェブカメラの設定を調整するには (解像度など)、[https://github.com/mpv-player/mpv/wiki/Video4Linux2-Input mpv のドキュメント] を見てください。

=== FFmpeg ===

ウェブカメラの無いノートパソコンの場合、droidcam の代替として IP カメラを使用できます。こうすることで、追加のウェブカメラデバイスがかさばることはありません。Android の場合、[https://play.google.com/store/apps/details?id=com.pas.webcam IP ウェブカメラ]のようなものを携帯電話でホストし、ノートパソコンのビデオ入力として IP カメラを使用できます。まず、{{Pkg|linux-headers}} と {{Pkg|v4l2loopback-dkms}} をインストールしてください。次に、{{ic|v4l2loopback}} を使ってビデオソースに {{ic|v4l2loopback}} として接続してください、携帯電話の IP アドレスが {{ic|192.168.1.xxx}} であるとすると:

 # modprobe v4l2loopback exclusive_caps=1
 $ ffmpeg -i http://192.168.1.xxx:8080/video -vf format=yuv420p -f v4l2 /dev/video0

{{Note|{{ic|1=exclusive_caps=1}} は、一部の Chrome/WebRTC アプリケーションでビデオ入力が利用できない問題を解決します [https://github.com/umlaeute/v4l2loopback#options]。}}

== トラブルシューティング ==

=== V4L1 サポート ===

Linux カーネルのバージョン 2.6.27 で、レガシーな Video4Linux (1) API のサポートが打ち切られました。Video4Linux バージョン 2 はカーネルスペースでのデコードをサポートしていないため、ピクセル形式のデコードはユーザスペースで行うようになりました。libv4l ライブラリは、ユーザランドのアプリケーションにピクセルデコードサービスを提供し、ほとんどのプログラムで使用されるようになるでしょう。他の互換レイヤも利用可能です。

'''デバイスファイルが作成されたが、画像がおかしい場合 (例えば、ほぼ完全に緑になっている)、おそらく以下のことを行う必要があります。'''

アプリケーションが V4L2 に対応しているが、ピクセル形式に対応していない場合、以下のコマンドを使ってください:
 LD_PRELOAD=/usr/lib/libv4l/v4l2convert.so application

アプリケーションが古いバージョンの V4L にしか対応していない場合、以下のコマンドを使ってください:
 LD_PRELOAD=/usr/lib/libv4l/v4l1compat.so application

{{Tip|1=上記の長いコマンドを毎回入力する手間を省くために、以下のような行を {{ic|/etc/profile}} か [[xprofile]] に追加することができます: {{ic|1=export LD_PRELOAD=/usr/lib/libv4l/v4l2convert.so}} あるいは {{ic|1=export LD_PRELOAD=/usr/lib/libv4l/v4l1compat.so}}}}

32ビットの [[multilib]] アプリケーションの場合は、{{Pkg|lib32-v4l-utils}} パッケージを[[インストール]]して、上記のコマンドの {{ic|/usr/lib/libv4l/}} の部分を {{ic|/usr/lib32/libv4l/}} に置き換えてください。

=== xawtv と nvidia カード ===

nvidia のグラフィックカードを使用していて、以下のようなエラーが発生する場合:
 X Error of failed request:  XF86DGANoDirectVideoMode
  Major opcode of failed request:  139 (XFree86-DGA)
  Minor opcode of failed request:  1 (XF86DGAGetVideoLL)
  Serial number of failed request:  69
  Current serial number in output stream:  69
xawtv を {{ic|$ xawtv -nodga}} として実行する必要があります。

=== Microsoft Lifecam Studio/Cinema ===

特定の設定下で、Microsoft lifecam studio/cinema は過大な usb 帯域を要求して失敗します、[https://www.ideasonboard.org/uvc/#footnote-13 Uvcvideo FAQ] を見て下さい。この場合、{{ic|uvcvideo}} ドライバーを {{ic|1=quirks=0x80}} でロードしてください。以下を {{ic|/etc/modprobe.d/uvcvideo.conf}} に追加します:

{{hc|1=/etc/modprobe.d/uvcvideo.conf|2=
## fix bandwidth issue for lifecam studio/cinema
options uvcvideo quirks=0x80
}}

{{Note|ログで遅延が確認できたり、カメラが断続的に動作する場合、上記の方法で解決できます。{{ic|1=quirks=0x100}} のように大きな値を使うことも可能です。}}

=== Skype ===

ウェブカメラをテストする際は、以下のことに注意してください:
* echobot は videochat をサポートしていません。ウェブカメラをテストするために使用しないでください。
* Skype は異なるビデオデバイス/カメラデバイス (/dev/video*) を認識するかもしれません。これらのデバイスは、カメラの設定画面のドロップダウンメニューで "integrated camera..." のようにリストアップされます。それぞれのカメラを試し、数秒間待ってください (別のカメラに切り替えるのに時間がかかるからです)。

=== USB ウェブカメラにより使用されている帯域幅を確認する ===

ひとつの USB バスで複数のウェブカメラを使用した場合、USB バスの帯域幅が足りずにウェブカメラが機能しなくなることがあります。{{AUR|usbtop}} パッケージの ''usbtop'' ツールで問題を診断できます。

=== ビデオストリームを反転させる ===

ビデオストリームが反転している場合、反転しているビデオをさらに反転させる仮想ビデオカメラを作成することができます。{{Pkg|v4l-utils}} と {{Pkg|v4l2loopback-dkms}} を[[インストール]]する必要があります。仮想ビデオカメラを作成してください:

 # modprobe v4l2loopback

新しく作成したカメラの名前を確認してください:

 $ v4l2-ctl --list-devices
 Dummy video device (0x0000) (platform:v4l2loopback-000):
    	/dev/video1

これで、{{Pkg|ffmpeg}} を実行して、実際のウェブカメラ (ここでは {{ic|/dev/video0}}) からビデオを読み出し、それを反転させて、仮想カメラに書き込むことができます:

 $ ffmpeg -f v4l2 -i /dev/video0 -vf "vflip" -f v4l2 /dev/video1

ここで、{{ic|vflip}} はビデオストリームを垂直方向に反転させます。水平方向に反転させるには {{ic|hflip}} を使用してください。

エラーを避けるために、format 引数 {{ic|yuv420p}} が必要かもしれません。そうしないと、ビデオストリームを取得できず、黒画面が表示されるかもしれません [https://stackoverflow.com/questions/61485726/ffmpeg-flip-horizontally-webcam-to-virtual-video-camera/63943783#63943783]。言い換えると:

 $ ffmpeg -f v4l2 -i /dev/video0 -vf "hflip,format=yuv420p" -f v4l2 /dev/video1

これで、アプリケーションで "Integrated" カメラの代わりに "Dummy" カメラを使えるようになります。

=== 画像の品質が悪い ===

画像が明るすぎたり、暗すぎたり、露出が高すぎたりする場合、{{AUR|v4l2ucp}} をインストールして画像出力を調整できます。