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

[[Category:イメージング]]
[[en:Webcam setup]]
[[es:Webcam setup]]
[[ru:Webcam setup]]
[[zh-hans:Webcam setup]]
こちらは Arch Linux でウェブカメラを設定するガイドです。

== 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 ===

サポートされているウェブカメラの完全なリストは [http://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]。

== ソフトウェアでウェブカメラを使う ==

Linux カーネルのバージョン 2.6.27 は [http://mxhaard.free.fr/spca5xx.html 多数の新しいウェブカメラドライバー] をサポートしています。レガシーな Video4Linux API は廃止され、現在これらのドライバーは Video4Linux バージョン 2 のみをサポートしています。Video4Linux バージョン 2 からピクセル形式のデコードはユーザースペースに移り、カーネルスペースでのデコードはサポートしていません。libv4l ライブラリがピクセスデコードサービスのユーザーランドアプリケーションを提供しており、多くのプログラムで使用されます。他の互換レイヤーも利用可能です。

'''デバイスが作成されたが画像がおかしい場合 (完全に緑など)、以下の設定が必要かもしれません。'''

アプリケーションが V4L2 をサポートしているがピクセル形式をサポートしていない場合 (例: cheese) 次のコマンドを使って下さい:
 LD_PRELOAD=/usr/lib/libv4l/v4l2convert.so cheese

アプリケーションが V4L の古いバージョンしかサポートしていない場合 (Skype がこの種のソフトウェアで一番有名です) 次のコマンドを使って下さい:
 LD_PRELOAD=/usr/lib/libv4l/v4l1compat.so skype

{{Tip|1=以下のような行を {{ic|/etc/profile}} や [[xprofile]] に追加することで長いコマンドを毎回入力する手間が省けます:
 {{bc|1=export LD_PRELOAD=/usr/'$LIB'/libv4l/v4l2convert.so}}
または:
 {{bc|1=export LD_PRELOAD=/usr/'$LIB'/libv4l/v4l1compat.so}}
}}

Arch64 で32ビットのアプリケーションを使う場合 (例: Skype)、{{Pkg|lib32-v4l-utils}} パッケージをインストールして下さい。

ウェブカメラが guvcview で問題なく動くのに、Skype で動かない場合、起動する前に次も設定する必要があるかもしれません:
 export XLIB_SKIP_ARGB_VISUALS=1

=== Cheese ===

Cheese は GNOME の静画・動画トーククライアントです。macOS の Photo Booth に似ています。公式リポジトリからインストール可能です ({{Pkg|cheese}})。

=== fswebcam ===

fswebcam は軽量で柔軟性のあるウェブカメラアプリで、コマンドラインから起動することができます。[[公式リポジトリ]]の {{AUR|fswebcam}} パッケージでインストールしてください。

=== GTK+ UVC Viewer (guvcview) ===

ウェブカメラの設定ができる便利なソフトウェアというだけでなく、[http://guvcview.sourceforge.net/ guvcview] は Linux UVC ドライバーがサポートしているデバイスから動画をキャプチャ（音付きで！）・表示することもできます。{{Pkg|guvcview}} パッケージとして[[公式リポジトリ]]から利用可能です。

=== Kopete ===

Kopete は [[KDE]] のインスタントメッセージ (IM) クライアントです。{{Pkg|kdenetwork-kopete}}{{Broken package link|置換パッケージ: {{Pkg|kopete}}}} パッケージでインストールできます。{{Grp|kdenetwork}} グループに含まれています。

=== Kamoso ===

ウェブカメラから写真や動画を撮影する KDE のアプリケーション。{{Pkg|kamoso}} パッケージをインストールしてください。

=== xawtv ===

これは v4l デバイスの素朴なビューアで、TV チューナーカードで使うことが想定されていながら、ウェブカメラでも問題なく動作します。ウィンドウにウェブカメラの映像を表示します。インストールして ({{Pkg|xawtv}}) 次のコマンドで起動してください:
 $ xawtv -c /dev/video0
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 -nodga

=== VLC ===

[[VLC media player|VLC]] を使ってウェブカメラを表示したり記録することもできます。VLC のファイルメニューで、'Capture Device...' ダイアログを開いて動画と音声のデバイスファイルを入力してください。もしくはコマンドラインから次を実行します:
 $ vlc v4l:// :v4l-vdev="/dev/video0" :v4l-adev="/dev/audio2"
これで 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}}"

上記のコマンドでは、何を記録しているのか表示されません。確認したい場合は、以下のように dst にディスプレイを追加する必要があります (ハードウェアの負担は増えます):
 ... :duplicate{dst=display,dst=std{access= ....

=== MPlayer ===

[[MPlayer]] を使ってウェブカメラのスナップショットを撮るにはターミナルから次のコマンドを実行します:
 $ mplayer tv:// -tv driver=v4l2:width=640:height=480:device=/dev/video0 -fps 15 -vf screenshot
ここから {{ic|s}} を押すことでスナップショットが作られます。スナップショットはあなたのカレントフォルダに '''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}} を押せば録画が終了します。

=== mpv ===

[[mpv]] を使ってウェブカメラの画像を取得するにはターミナルから以下のコマンドを実行:
 $ mpv tv:// --tv-driver=v4l2 --tv-device=/dev/video0
{{ic|s}} を押すことでスナップショットが取得されます。スナップショットはカレントフォルダに '''mpv-shotNNNN.jpg''' という名前で保存されます。

=== FFmpeg ===

[[FFmpeg#ウェブカメラの録画]] を見て下さい。

=== ekiga ===

Microsoft NetMeeting にとてもよく似ています。公式リポジトリから {{pkg|ekiga}} パッケージをインストールして下さい。設定は全て勝手にやってくれます。

=== Sonic-snap ===

Sonic-snap [http://www.stolk.org/sonic-snap/] は sn9c102 ベースのウェブカメラ'''専用'''のビューア・レコーダです。{{AUR|sonic-snap}}{{Broken package link|{{aur-mirror|sonic-snap}}}} は AUR から入手可能です。

=== Skype === 

[[Skype]] の最新版は動画をサポートしています。オプションのビデオデバイスを確認してください、テスト画像をダブルクリックすることでフルスクリーンにできます。{{AUR|skype}}{{Broken package link|パッケージが存在しません}} パッケージをインストールして下さい。Skype で緑の画像が表示される場合は上の[[#ソフトウェアでウェブカメラを使う|ソフトウェアでウェブカメラを使う]]セクションを見て下さい。

x86-64 を使っている場合は {{Pkg|lib32-v4l-utils}} をインストールして次のコマンドで skype を起動してください:
 LD_PRELOAD=/usr/lib32/libv4l/v4l1compat.so skype
skype のエイリアスを作成するか、{{ic|/usr/bin}} にあるオリジナルの skype バイナリの名前を変更してから上記のオプションを記述したテキストファイルを作成するか、あるいは、デスクトップ環境で Skype アイコンのコマンドラインオプションを変更することで、恒常的に使うことができます。

=== Motion ===

:''Motion はカメラからのビデオ信号を監視するプログラムです。映像の一部が変わったのを検出することが可能で、言い換えれば、動き検出が可能です。''

{{AUR|motion}} は v4l2 デバイスしか処理できないため v4l1 ドライバーしかないカメラを使う時は前述の通りに v4l1compat.so をプリロードする必要があります。そうしないと motion が適切なパレットを見つけられないというエラーが起こります。

=== MJPG-streamer ===

{{AUR|mjpg-streamer}} は Linux-UVC 対応のウェブカメラ、ファイルシステム、あるいは他の入力プラグインから JPG を取得して HTTP を介しウェブブラウザや VLC などのソフトウェアに M-JPEG としてストリーミングします。

=== QtCAM ===

QtCAM はオープンソースの Linux ウェブカメラソフトウェアです。USB カメラや V4L2 に対応しているデバイスから動画や画像を取得することができます。色空間の切り替えや、フレームレートの表示などの機能があります。

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

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

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

=== USB ウェブカメラによって使われている帯域幅をチェック ===

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