Forward: add backend comment in full.conf and update forward.backend.conf.

chundonglinlin · chundonglinlin · commit 66af013a9ecc · 2022-02-15T17:45:43.000+08:00
diff --git a/trunk/conf/forward.backend.conf b/trunk/conf/forward.backend.conf
@@ -4,7 +4,7 @@
 
 listen              1935;
 max_connections     1000;
-pid                 ./objs/srs.master.pid;
+pid                 ./objs/srs.backend.pid;
 daemon              off;
 srs_log_tank        console;
 vhost __defaultVhost__ {
diff --git a/trunk/conf/full.conf b/trunk/conf/full.conf
@@ -670,30 +670,32 @@ vhost same.vhost.forward.srs.com {
         # format: {ip}:{port} {ip_N}:{port_N}
         destination 127.0.0.1:1936 127.0.0.1:1937;
 
-        # when client(encoder) publish to vhost/app/stream, then create forwarder, call the hook,
+        # when client(encoder) publish to vhost/app/stream, call the hook in creating backend forwarder.
         # the request in the POST data string is a object encode by json:
         #       {
         #           "action": "on_forward",
         #           "server_id": "vid-k21d7y2",
         #           "client_id": "9o7g1330",
         #           "ip": "127.0.0.1",
-        #           "vhost": "video.test.com",
+        #           "vhost": "__defaultVhost__",
         #           "app": "live",
         #           "tcUrl": "rtmp://127.0.0.1:1935/live",
         #           "stream": "livestream",
-        #           "param": "?forward=rtmp://ossrs.net/live/livestream"
+        #           "param": ""
         #       }
         # if valid, the hook must return HTTP code 200(Status OK) and response
         # an int value specifies the error code(0 corresponding to success):
         #       {
         #          "code": 0,
         #          "data": {
         #              "urls":[
-        #                 "rtmp://ossrs.net:1935/live/livestream?auth_token=xxx",
-        #                 "rtmp://cdn.com:1935/live/livestream?auth_token=xxx"
+        #                 "rtmp://127.0.0.1:19350/test/teststream"
         #              ]
         #          }
         #       }
+        # PS: you can transform params to backend service, such as:
+        #       { "param": "?forward=rtmp://127.0.0.1:19351/test/livestream" }
+        #     then backend return forward's url in response.
         # only support one api hook, format:
         #       backend http://xxx/api0
         backend http://127.0.0.1:8085/api/v1/forward;
