Debug log

cd nginx-X.Y.Z
./configure --add-module=/path/to/nginx-rtmp-module --with-debug ...

編譯一套nginx的error.log中水平nginx.conf調試後

error_log logs/error.log debug;

這以後，你將有不少的error.log中調試信息。

Exec wrapper in bash

你能夠用任何語言編寫的exec包裝。然而，你應該注意終止進程。當出版商關閉流的全部執行處理被終止。若是指定的exec指令，而不是真正的ffmpeg的包裝，那麼你最終可能會與你的ffmpeg還活着，孤兒，直到超時讀取輸入數據。

該解決辦法是用信號陷阱。下面是在bash這種包裝的一個例子。

#!/bin/bash

on_die ()
{
    # kill all children
    pkill -KILL -P $$
}

trap 'on_die' TERM
ffmpeg -i rtmp://localhost/myapp/$1 -c copy -f flv rtmp://localhost/myapp2/$1 &
wait

該腳本註冊它終止子的ffmpeg SIGTERM處理器。 nginx的，RTMP發送默認的信號是SIGKILL不能被捕獲。對於上面的腳本按預期的行爲，你須要exec_kill_signal指令來改變EXEC終止信號。它接受數字或符號信號名稱（POSIX.1-1990信號）。這裏的示例應用程序。

application myapp {
    live on;

    exec /var/scripts/exec_wrapper.sh $name;
    exec_kill_signal term;
}

application myapp2 {
    live on;
}

Examples 一些實例

簡單的視頻點播

rtmp {
    server {
        listen 1935;
        application vod {
            play /var/flvs;
        }
    }
}

簡單的直播服務

rtmp {
    server {
        listen 1935;
        application live {
            live on;
        }
    }
}

從新翻譯遠程流

rtmp {
    server {
        listen 1935;
        application tv {
            live on;
            pull rtmp://cdn.example.com:443/programs/main pageUrl=http://www.example.com/index.html name=maintv;
        }
    }
}

從新翻譯與HLS支持遠程流

rtmp {
    server {
        listen 1935;
        application tv {
            live on;

            hls on;
            hls_path /tmp/tv2;
            hls_fragment 15s;

            pull rtmp://tv2.example.com:443/root/new name=tv2;
        }
    }
}

http {
    server {
        listen 80;
        location /tv2 {
            alias /tmp/tv2;
        }
    }
}

物流經過RTMP你的X屏幕

ffmpeg -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 -f flv rtmp://localhost/myapp/screen

Set up live streaming

要創建RTMP支持，你須要添加RTMP{}部分nginx.conf（PREFIX/conf/nginx.conf)）。股票nginx.conf只包含HTTP{}部分。

使用此nginx.conf，而不是原始的配置：

#user  nobody;
worker_processes  1;

error_log  logs/error.log debug;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;
    keepalive_timeout  65;

    server {
        listen       8080;
        server_name  localhost;

        # sample handlers
        #location /on_play {
        #    if ($arg_pageUrl ~* localhost) {
        #        return 201;
        #    }
        #    return 202;
        #}
        #location /on_publish {
        #    return 201;
        #}

        #location /vod {
        #    alias /var/myvideos;
        #}

        # rtmp stat
        location /stat {
            rtmp_stat all;
            rtmp_stat_stylesheet stat.xsl;
        }
        location /stat.xsl {
            # you can move stat.xsl to a different location
            root /usr/build/nginx-rtmp-module;
        }

        # rtmp control
        location /control {
            rtmp_control all;
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

rtmp {
    server {
        listen 1935;
        ping 30s;
        notify_method get;

        application myapp {
            live on;

            # sample play/publish handlers
            #on_play http://localhost:8080/on_play;
            #on_publish http://localhost:8080/on_publish;

            # sample recorder
            #recorder rec1 {
            #    record all;
            #    record_interval 30s;
            #    record_path /tmp;
            #    record_unique on;
            #}

            # sample HLS
            #hls on;
            #hls_path /tmp/hls;
            #hls_sync 100ms;
        }

        # Video on demand
        #application vod {
        #    play /var/Videos;
        #}

        # Video on demand over HTTP
        #application vod_http {
        #    play http://localhost:8080/vod/;
        #}
    }
}

Statistics (統計)

在瀏覽器中輸入 http://localhost:8080/stat 看到目前的流媒體統計，鏈接的客戶端，帶寬等。

Publishing with ffmpeg

發佈現場視頻流最簡單的方法是使用的ffmpeg（或avconv）。它已經安裝在大多數系統中，也方便安裝在其餘的上面。

RTMP僅支持的編解碼器的數量有限。最流行的RTMP視頻編解碼器是H264，索倫森-H263（又名FLV）和音頻編解碼器AAC，MP3，獲得Nellymoser，Speex語音。

若是您的視頻與這些編解碼器編碼（最多見的是對H264 / AAC），那麼你不須要任何轉換。不然，你須要將視頻轉換爲支持的編解碼之一。

咱們將流測試文件 /var/videos/test.mp4 to server with ffmpeg.

Streaming without conversion (given test.mp4 codecs are compatible with RTMP)

ffmpeg -re -i /var/Videos/test.mp4 -c copy -f flv rtmp://localhost/myapp/mystream

Streaming and encoding audio (AAC) and video (H264), need libx264 and libfaac

ffmpeg -re -i /var/Videos/test.mp4 -c:v libx264 -c:a libfaac -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream

Streaming and encoding audio (MP3) and video (H264), need libx264 and libmp3lame

ffmpeg -re -i /var/Videos/test.mp4 -c:v libx264 -c:a libmp3lame -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream

Streaming and encoding audio (Nellymoser) and video (Sorenson H263)

ffmpeg -re -i /var/Videos/test.mp4 -c:v flv -c:a nellymoser -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream

Publishing video from webcam

ffmpeg -f video4linux2 -i /dev/video0 -c:v libx264 -an -f flv rtmp://localhost/myapp/mystream

Playing with ffplay

ffplay rtmp://localhost/myapp/mystream

Publishing and playing with flash

See test/rtmp-publisher directory for test flash applets and html.

視頻直播點播nginx-rtmp開發手冊中文版

核心

application

timeout 超時

ping

ping_timeout

max_streams 單一流數據最大限制

ack_window

chunk_size 數據塊大小

max_queue 最大隊列數

max_message

buflen 緩衝區

out_queue

out_cork

Access 訪問控制

allow

deny

Exec

exec_push

env PATH;

exec_pull

exec

exec_options

exec_static

exec_kill_signal

respawn

respawn_timeout

exec_publish

exec_play

exec_play_done

exec_publish_done

exec_record_done

Live

live

meta

interleave

wait_key

wait_video

publish_notify

drop_idle_publisher

sync

play_restart

idle_streams

record

record_path

record_suffix

record_unique

record_append

record_lock

record_max_size

record_max_frames

record_interval

recorder

record_notify

Video on demand 視頻點播

play

play_temp_path

play_local_path

Relay 中繼

pull

push

push_reconnect

session_relay

Notify

on_connect

on_play

on_publish

on_done

on_play_done

on_publish_done

on_record_done

on_update

notify_update_timeout

notify_update_strict

notify_relay_redirect

notify_method

HLS

hls_path

hls_fragment

hls_playlist_length

`deny`

`exec_kill_signal`