piliv2 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 698dc78d73f17a61df99562bafa0147e5b0a03cc
+  data.tar.gz: 805206f6c3a86feeaf724fae2b3ef338a831dba8
+SHA512:
+  metadata.gz: 71ff1db811bc913d6982f2a75785342747db9737c9a0e53961d48dfc774b908dc47320822689e8f12f5ff1d81ff1235449b3834aa5bd820dab6f0b25b36772a3
+  data.tar.gz: 1517952e3cfd76a6e3eb9500fe02a6e974dea49d9661c31f1675188c0c3be476e3d995ffb95cfc7ab04bb49ce76a7492f0232a79d5e5e2dc3ae01ab019c69648

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+  - 2.2.5
+gemfile:
+  - Gemfile
+deploy:
+  provider: rubygems
+  api_key:
+    secure: frhK5TRyrplKjwEktkjx4nGyXBhELae7B/rfDTWUqLrwX4Gmx2XTf0j3VSwKphf2PclW2Phs1o029JFjivgjCB0gYpb4/lgPLxXAjYoUv7cbyZ1SdvIkhJsxilPgkPOr/t6XZ4OB1WU0yLJxDKNyJCh6fHJ47OlMfy7neGPtFKI=
+  gemspec: pili.gemspec
+  on:
+    tags: true

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in pili.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 pili.qiniu.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,224 @@
+# Pili Streaming Cloud server-side library for Ruby
+
+## Features
+
+- URL
+	- [x] RTMP推流地址: rtmp_publish_url(domain, hub, stream_key, mac, expire_after_seconds)
+	- [x] RTMP直播地址: rtmp_play_url(domain, hub, stream_key)
+	- [x] HLS直播地址: hls_play_url(domain, hub, stream_key)
+	- [x] HDL直播地址: hdl_play_url(domain, hub, stream_key)
+	- [x] 截图直播地址: snapshot_play_url(domain, hub, stream_key)
+- Hub
+	- [x] 创建流: hub.create(stream_key)
+	- [x] 获得流: hub.stream(stream_key)
+	- [x] 列出流: hub.list(...)
+	- [x] 列出正在直播的流: hub.list_live(...)
+- Stream
+	- [x] 流信息: stream.info()
+	- [x] 禁用流: stream.disable()
+	- [x] 启用流: stream.enable()
+ 	- [x] 查询直播状态: stream.live_status()
+	- [x] 保存直播回放: stream.save(...)
+	- [x] 查询直播历史: stream.history_activity(...)
+
+## Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Configuration](#configuration)
+	- [URL](#url)
+		- [Generate RTMP publish URL](#generate-rtmp-publish-url)
+		- [Generate RTMP play URL](#generate-rtmp-play-url)
+		- [Generate HLS play URL](#generate-hls-play-url)
+		- [Generate HDL play URL](#generate-hdl-play-url)
+		- [Generate Snapshot play URL](#generate-snapshot-play-url)
+	- [Hub](#hub)
+		- [Instantiate a Pili Hub object](#instantiate-a-pili-hub-object)
+		- [Create a new Stream](#create-a-new-stream)
+		- [Get a Stream](#get-a-stream)
+		- [List Streams](#list-streams)
+		- [List live Streams](#list-live-streams)
+	- [Stream](#stream)
+		- [Get Stream info](#get-stream-info)
+		- [Disable a Stream](#disable-a-stream)
+		- [Enable a Stream](#enable-a-stream)
+		- [Get Stream live status](#get-stream-live-status)
+		- [Get Stream history activity](#get-stream-history-activity)
+		- [Save Stream live playback](#save-stream-live-playback)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'piliv2'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install piliv2
+
+
+## Usage
+
+### Configuration
+
+```ruby
+require "piliv2"
+
+access_key = "<QINIU ACCESS KEY>" # 替换成自己 Qiniu 账号的 AccessKey.
+secret_key = "<QINIU SECRET KEY>" # 替换成自己 Qiniu 账号的 SecretKey.
+hub_name   = "<PILI HUB NAME>"    # Hub 必须事先存在.
+
+mac = Pili::Mac.new(access_key, secret_key)
+client = Pili::Client.new(mac)
+hub = client.hub(hub_name)
+```
+
+### URL
+
+#### Generate RTMP publish URL
+
+```ruby
+url = Pili.rtmp_publish_url("publish-rtmp.test.com", "PiliSDKTest", "streamkey", 60)
+puts(url)
+# rtmp://publish-rtmp.test.com/PiliSDKTest/streamkey?e=1463023142&token=7O7hf7Ld1RrC_fpZdFvU8aCgOPuhw2K4eapYOdII:-5IVlpFNNGJHwv-2qKwVIakC0ME=
+```
+
+#### Generate RTMP play URL
+
+```ruby
+url = Pili.rtmp_play_url("live-rtmp.test.com", "PiliSDKTest", "streamkey")
+puts(url)
+# rtmp://live-rtmp.test.com/PiliSDKTest/streamkey
+```
+
+#### Generate HLS play URL
+
+```ruby
+url = Pili.hls_play_url("live-hls.test.com", "PiliSDKTest", "streamkey")
+puts(url)
+# http://live-hls.test.com/PiliSDKTest/streamkey.m3u8
+```
+
+#### Generate HDL play URL
+
+```ruby
+url = Pili.hdl_play_url("live-hdl.test.com", "PiliSDKTest", "streamkey")
+puts(url)
+# http://live-hdl.test.com/PiliSDKTest/streamkey.flv
+```
+
+#### Generate Snapshot play URL
+
+```ruby
+url = Pili.snapshot_play_url("live-snapshot.test.com", "PiliSDKTest", "streamkey")
+puts(url)
+# http://live-snapshot.test.com/PiliSDKTest/streamkey.jpg
+```
+
+### Hub
+
+#### Instantiate a Pili Hub object
+
+```ruby
+mac = Pili::Mac.new(access_key, secret_key)
+client = Pili::Client.new(mac)
+hub = client.hub("PiliSDKTest")
+```
+
+#### Create a new Stream
+
+```ruby
+stream = hub.create("streamkey")
+puts(stream.info.to_json)
+# {"hub":"PiliSDKTest","key":"streamkey","disabled":false}
+```
+
+#### Get a Stream
+
+```ruby
+stream = hub.stream("streamkey")
+puts(stream.info.to_json)
+# {"hub":"PiliSDKTest","key":"streamkey","disabled":false}
+```
+
+#### List Streams
+
+```ruby
+keys, marker = hub.list(:prefix=>"str", :limit=>10)
+puts keys.to_s, marker
+# [<keys...>], <marker>
+```
+
+#### List live Streams
+
+```ruby
+keys, marker = hub.list_live(:prefix=>"str", :limit=>10)
+puts keys.to_s, marker
+# [<keys...>], <marker>
+```
+
+### Stream
+
+#### Get Stream info
+
+```ruby
+stream = hub.stream(key)
+puts(stream.info.to_json)
+# {"hub": "PiliSDKTest", "key": "streamkey", "disabled": false}
+```
+
+#### Disable a Stream
+
+```ruby
+stream = hub.stream("streamkey")
+puts("before disable: #{stream.info.to_json}")
+
+stream.disable()
+
+stream = hub.stream("streamkey")
+puts("after disable: #{stream.info.to_json}")
+# before disable: {"hub":"PiliSDKTest","key":"streamkey","disabled":false}
+# after disable: {"hub":"PiliSDKTest","key":"streamkey","disabled":true}
+```
+
+#### Enable a Stream
+
+```ruby
+stream = hub.stream("streamkey")
+puts("before enable: #{stream.info.to_json}")
+
+stream.enable()
+
+stream = hub.get("streamkey")
+puts("after enable: #{stream.info.to_json}")
+# before disable: {"hub":"PiliSDKTest","key":"streamkey","disabled":true}
+# after disable: {"hub":"PiliSDKTest","key":"streamkey","disabled":false}
+```
+
+#### Get Stream live status
+
+```ruby
+status = stream.live_status()
+puts(status.to_json)
+# {"startAt":1463022236,"clientIP":"222.73.202.226","bps":248,"fps":{"audio":45,"vedio":28,"data":0}}
+```
+
+#### Get Stream history activity 
+
+```ruby
+activity = stream.history_activity()
+puts(activity.to_json)
+# [{"start":1463022236,"end":1463022518}]
+```
+
+#### Save Stream live playback
+
+```ruby
+fname = stream.save()
+puts(fname)
+# recordings/z1.PiliSDKTest.streamkey/1463156847_1463157463.m3u8
+```

data/Rakefile

@@ -0,0 +1,3 @@
+require "bundler/gem_tasks"
+
+task :default => [] # Just in case it hasn't already been set

data/example/example.rb

@@ -0,0 +1,111 @@
+require 'pili'
+
+access_key = ENV["PILI_ACCESS_KEY"]
+secret_key = ENV["PILI_SECRET_KEY"]
+
+hub_name = ENV["PILI_HUB_NAME"]
+
+if access_key == nil || secret_key == nil
+  raise 'access_key = #{access_key} secret_key = #{secret_key}'
+end
+
+srand
+stream_key_prefix = "ruby-sdkexample-#{rand 1000000000}"
+
+puts "初始化 client."
+mac = Pili::Mac.new access_key, secret_key
+client = Pili::Client.new mac
+hub = client.hub hub_name
+
+puts "获得不存在的流."
+key_a = stream_key_prefix + "-a"
+begin
+  stream_a = hub.stream key_a
+  stream_a.info
+rescue Pili::ResourceNotExist => e
+  puts e
+end
+
+puts "创建流."
+stream_a = hub.create(key_a)
+puts stream_a.info
+
+puts "获得流."
+stream_a = hub.stream(key_a)
+puts "to_json: #{stream_a.info.to_json}"
+
+puts "创建重复的流."
+begin
+  hub.create(key_a)
+rescue Pili::ResourceConflict => e
+  puts e
+end
+
+puts "创建另一路流."
+key_b = stream_key_prefix + "-b"
+stream_b = hub.create(key_b)
+puts stream_b.info
+
+puts "列出所有流."
+begin
+  keys, marker = hub.list(:prefix=>stream_key_prefix)
+  puts keys.to_s, marker
+rescue Pili::ResourceNotExist => e
+  puts e
+end
+
+puts "列出正在直播的流."
+begin
+  keys, marker = hub.list_live(:prefix=>stream_key_prefix)
+  puts keys.to_s, marker
+rescue Pili::ResourceNotExist => e
+  puts e
+end
+
+puts "禁用流."
+stream_a.disable()
+puts stream_a.info
+
+puts "启用流."
+stream_a.enable()
+puts stream_a.info
+
+puts "查询直播状态."
+begin
+  status = stream_a.live_status()
+  puts keys, marker
+rescue Pili::ResourceNotExist => e
+  puts e
+end
+
+puts "查询推流历史."
+activity = stream_a.history_activity()
+puts activity
+
+puts "保存直播数据."
+begin
+  fname = stream_a.save()
+  puts fname
+rescue Exception => e
+  puts e
+end
+
+puts "RTMP 推流地址."
+url = Pili.rtmp_publish_url("publish-rtmp.test.com", hub_name, key_a, mac, 3600)
+puts url
+
+puts "RTMP 直播放址."
+url = Pili.rtmp_play_url("live-rtmp.test.com", hub_name, key_a)
+puts url
+
+puts "HLS 直播地址."
+url = Pili.hls_play_url("live-hls.test.com", hub_name, key_a)
+puts url
+
+puts "HDL 直播地址."
+url = Pili.hdl_play_url("live-hdl.test.com", hub_name, key_a)
+puts url
+
+puts "截图直播地址"
+url = Pili.snapshot_play_url("live-snapshot.test.com", hub_name, key_a)
+puts url

data/lib/pili/auth.rb

@@ -0,0 +1,48 @@
+# coding: utf-8
+require 'digest/hmac'
+require "base64"
+
+module Pili
+  class Mac
+
+    attr_reader :access_key, :secret_key
+
+    def initialize(access_key, secret_key)
+      @access_key = access_key
+      @secret_key = secret_key
+    end
+
+    def sign(data)
+      signature = Base64.urlsafe_encode64(Digest::HMAC.digest(data, @secret_key, Digest::SHA1))
+      "#{@access_key}:#{signature}"
+    end
+    
+    def inc_body(req, content_type)
+      type_ok = content_type != nil && content_type != "application/octet-stream"
+      length_ok = req.content_length != nil && req.content_length > 0 && req.content_length < 1024*1024
+      req.body != nil && type_ok && length_ok
+    end
+ 
+    def sign_request(req)
+      data = "#{req.method} #{req.path}"
+      
+      # FIXME: how to deal with port, because default uri.port is 80
+      data += "\nHost: #{req.uri.host}"
+      
+      content_type = req["Content-Type"]
+      if content_type != nil
+        data += "\nContent-Type: #{content_type}"
+      end
+      
+      data += "\n\n"
+      
+      if inc_body(req, content_type)
+        data += "#{req.body}"
+      end
+      
+      sign(data)
+    end
+    
+    private :inc_body
+  end
+end

data/lib/pili/client.rb

@@ -0,0 +1,48 @@
+# coding: utf-8
+
+module Pili
+  class Client
+    attr_reader :mac, :rpc
+  
+    def initialize(mac)
+      @mac = mac
+      @rpc = RPC.new mac
+    end
+    
+    # hub 初始化一个 Hub.
+    def hub(hub_name)
+      Hub.new hub_name, self
+    end
+  end
+  
+  class << self
+    # 生成 RTMP 推流地址.
+    # +expire_after_seconds+ 表示 URL 在多久之后失效.
+    def rtmp_publish_url(domain, hub, stream_key, mac, expire_after_seconds)
+      expire = Time.new.to_i + expire_after_seconds
+      path = "/#{hub}/#{stream_key}?e=#{expire}"
+      token = mac.sign(path)
+      "rtmp://#{domain}#{path}&token=#{token}"
+    end
+  
+    # 生成 RTMP 直播地址.
+    def rtmp_play_url(domain, hub, stream_key)
+      "rtmp://#{domain}/#{hub}/#{stream_key}"
+    end
+    
+    # 生成 HLS 直播地址.
+    def hls_play_url(domain, hub, stream_key)
+      "http://#{domain}/#{hub}/#{stream_key}.m3u8"
+    end 
+    
+    # 生成 HDL 直播地址.
+    def hdl_play_url(domain, hub, stream_key)
+      "http://#{domain}/#{hub}/#{stream_key}.flv"
+    end
+    
+    # 生成截图直播地址.
+    def snapshot_play_url(domain, hub, stream_key)
+      "http://#{domain}/#{hub}/#{stream_key}.jpg"
+    end
+  end
+end

data/lib/pili/config.rb

@@ -0,0 +1,27 @@
+# coding: utf-8
+module Pili
+  module Config
+    class << self
+
+      @@settings = {
+        :api_scheme  => "http",
+        :api_host    => "pili.qiniuapi.com",
+        :api_version => "v2",
+        :api_user_agent => "pili-sdk-ruby/v2-#{Pili::VERSION} Ruby/#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"
+      }
+
+      def init(options = {})
+        @@settings.merge!(options)
+      end
+      
+      def api_base_url
+        "#{@@settings[:api_scheme]}://#{@@settings[:api_host]}/#{@@settings[:api_version]}"
+      end
+      
+      def user_agent
+        @@settings[:api_user_agent]
+      end
+      
+    end
+  end
+end

data/lib/pili/exception.rb

@@ -0,0 +1,41 @@
+# coding: utf-8
+
+require "json"
+
+module Pili
+
+  class RPCError < Exception
+    
+    attr_reader :resp
+  
+    def initialize(message, resp)
+      @resp = resp
+      super(message)
+    end
+    
+    def code
+      resp.code
+    end
+    
+    def reqid
+      resp["X-Reqid"]
+    end
+    
+    def message
+      to_s
+    end
+    
+    def to_s
+      "#{super.to_s}: #{@resp.body}"
+    end
+  end
+  
+  # 资源已存在冲突错误
+  class ResourceConflict < RPCError
+  end
+  
+  # 资源不存在错误
+  class ResourceNotExist < RPCError
+  end
+  
+end

data/lib/pili/hub.rb

@@ -0,0 +1,93 @@
+# coding: utf-8
+module Pili
+  # Hub 表示一个 Hub, 一个 Hub 包含多个 Stream
+  class Hub
+    
+    attr_reader :hub
+    
+    def initialize(hub, client)
+      @hub = hub
+      @client = client
+      @base_url = "#{Config.api_base_url}/hubs/#{hub}"
+    end
+    
+    # 创建一个流对象.
+    # 使用一个合法 rtmp_publish_url 发起推流就会自动创建流对象.
+    # 一般情况下不需要调用这个 API, 除非是想提前对这一个流做一些特殊配置.    
+    def create(stream_key)
+      @client.rpc.call_with_json("POST", "#{@base_url}/streams", {:key => stream_key})
+      Stream.new(@hub, stream_key, @client)
+    end
+
+    # 初始化一个流对象.
+    def stream(stream_key)
+      Stream.new(@hub, stream_key, @client)
+    end
+
+    def plist(opt = {})
+      opt[:liveonly] ||= false
+      opt[:prefix] ||= ""
+      opt[:limit] ||= 0
+      opt[:marker] ||= ""
+      
+      ret = @client.rpc.call_with_json("GET", "#{@base_url}/streams?#{URI.encode_www_form opt}", nil)
+      [ret["items"].map{|x| x["key"]}, ret["marker"]]
+    end
+    private :plist
+    
+    # list 根据 prefix 遍历 Hub 的流列表.
+    # 
+    # 参数:
+    # 
+    # limit 限定了一次最多可以返回的流个数, 实际返回的流个数可能小于这个 limit 值.
+    # marker 是上一次遍历得到的流标.
+    # omarker 记录了此次遍历到的游标, 在下次请求时应该带上, 如果 omarker 为 "" 表示已经遍历完所有流.
+    #
+    # For example:
+    #
+    #   marker = ""
+    #   while true
+    #     keys, marker = hub.list(:marker=> marker)
+    #     # do something with keys.
+    #     if marker == ""
+    #       break
+    #     end
+    #   end
+    def list(opt = {})
+      opt[:liveonly] = false
+      plist(opt)
+    end
+    
+    # list 根据 prefix 遍历 Hub 正在播放的流列表.
+    # 
+    # 参数:
+    # 
+    # limit 限定了一次最多可以返回的流个数, 实际返回的流个数可能小于这个 limit 值.
+    # marker 是上一次遍历得到的流标.
+    # omarker 记录了此次遍历到的游标, 在下次请求时应该带上, 如果 omarker 为 "" 表示已经遍历完所有流.
+    #
+    # For example:
+    #
+    #   marker = ""
+    #   while true
+    #     keys, marker = hub.list_live(:marker=> marker)
+    #     # do something with keys.
+    #     if marker == ""
+    #       break
+    #     end
+    #   end
+    def list_live(opt = {})
+      opt[:liveonly] = true
+      plist(opt)
+    end
+    
+    def to_s
+      "#<#{self.class} #{@hub}>"
+    end
+    
+    def to_json
+      {:hub=>@hub}.to_json
+    end
+    
+  end
+end

data/lib/pili/rpc.rb

@@ -0,0 +1,60 @@
+# coding: utf-8
+require "json"
+require "net/http"
+
+module Pili
+  class RPC
+    def initialize(mac)
+      @mac = mac
+    end
+    
+    def new_request(method, url)
+      case method
+      when "POST"
+        req = Net::HTTP::Post.new(URI(url))
+      when "GET"
+        req = Net::HTTP::Get.new(URI(url))
+      else
+        raise "unsupport RPC method #{method}"
+      end
+      req["User-Agent"] = Config.user_agent()
+      req
+    end
+    
+    def request(req)
+      req["Authorization"] = "Qiniu #{@mac.sign_request req}"
+      Net::HTTP.start(req.uri.host, req.uri.port) {|http| http.request req}
+    end
+    
+    def call_with_json(method, url, params)
+      req = new_request(method, url)
+      
+      if method == "POST" && params != nil
+        req.body = params.to_json
+        req["Content-Type"] = "application/json"
+        req["Content-Length"] = req.body.length
+      end
+      resp = request(req)
+      if resp.code.start_with? "2"
+        if resp["Content-Type"] == "application/json"
+          JSON.load resp.body
+        else
+          resp.body
+        end
+      else
+        msg = "call #{url} failed: #{resp.code}"
+        case resp.code
+        when '612', '619'
+          e = ResourceNotExist.new msg, resp
+        when '614'
+          e = ResourceConflict.new msg, resp
+        else
+          e = RPCError.new msg, resp
+        end
+        raise e
+      end
+    end
+  end
+  
+  private_constant :RPC
+end

data/lib/pili/stream.rb

@@ -0,0 +1,115 @@
+# coding: utf-8
+
+require "base64"
+
+module Pili
+  class StreamInfo
+    attr_reader :hub, :key
+    
+    # 表示禁用结束的时间, 0 表示不禁用, -1 表示永久禁用.
+    attr_reader :disabled_till
+  
+    def initialize(hub, key, disabled_till)
+      @hub = hub
+      @key = key
+      @disabled_till = disabled_till
+    end
+    
+    def disabled?
+      @disabled_till == -1 || @disabled_till > Time.new.to_i
+    end
+    
+    def to_s
+      "#<#{self.class} #{@hub}/#{@key} disabled:#{disabled?}>"
+    end
+    
+    def to_json
+      {:hub=>@hub, :key=>@key, :disabled=>disabled?}.to_json
+    end
+  end
+
+  class Stream
+    attr_reader :hub, :key
+    
+    def initialize(hub, key, client)
+      @hub = hub
+      @key = key
+      
+      ekey = Base64.urlsafe_encode64(key)
+      @base_url = "#{Config.api_base_url}/hubs/#{hub}/streams/#{ekey}"
+      
+      @client = client
+    end
+    
+    # Info 获得流信息.
+    def info
+      ret = @client.rpc.call_with_json("GET", @base_url, nil)
+      StreamInfo.new @hub, @key, ret["disabledTill"]
+    end
+    
+    # 禁用一个流.
+    def disable
+      @client.rpc.call_with_json("POST", "#{@base_url}/disabled", {:disabledTill=>-1})
+    end
+    
+    # 启用一个流.
+    def enable
+      @client.rpc.call_with_json("POST", "#{@base_url}/disabled", {:disabledTill=>0})
+    end
+    
+    # 查询直播状态.
+    #
+    # 返回
+    #
+    #   {
+    #     "startAt" => <Integer>, # 直播开始的 Unix 时间戳, 0 表示当前没在直播.
+    #     "clientIp" => <String>, #  直播的客户端 IP.
+    #     "bps" => <Integer>, # 直播的码率、帧率信息.
+    #     "fps" => {
+    #       "audio" => <Integer>,
+    #       "video" => <Integer>,
+    #       "data" => <Integer>
+    #     }
+    #   }
+    def live_status
+      @client.rpc.call_with_json("GET", "#{@base_url}/live", nil)
+    end
+    
+    # 保存直播回放.
+    # 
+    # 参数: start, end 是 Unix 时间戳, 限定了保存的直播的时间范围, 0 值表示不限定, 系统会默认保存最近一次直播的内容.
+    # 
+    # 返回保存的文件名, 由系统生成.
+    def save(opt = {})
+      ret = @client.rpc.call_with_json("POST", "#{@base_url}/saveas", opt)
+      ret["fname"]
+    end
+    
+    # 查询直播历史.
+    #
+    # 参数: start, end 是 Unix 时间戳, 限定了查询的时间范围, 0 值表示不限定, 系统会返回所有时间的直播历史.
+    #
+    # 返回:
+    #
+    #   {
+    #     "start" => <Integer>,
+    #     "end" => <Integer>
+    #   }
+    def history_activity(opt = {})
+      url = "#{@base_url}/historyactivity"
+      if !opt.empty?
+        url += "?#{URI.encode_www_form opt}"
+      end
+      ret = @client.rpc.call_with_json("GET", url, nil)
+      ret["items"]
+    end
+    
+    def to_s
+      "#<#{self.class} #{@hub}/#{@key}>"
+    end
+    
+    def to_json
+      {:hub=>@hub, :key=>@key}.to_json
+    end
+  end
+end

data/lib/pili/version.rb

@@ -0,0 +1,3 @@
+module Pili
+  VERSION = "2.0.0"
+end

data/lib/pili.rb

@@ -0,0 +1,11 @@
+# coding: utf-8
+require 'json'
+
+require_relative "pili/version"
+require_relative "pili/config"
+require_relative "pili/exception"
+require_relative "pili/auth"
+require_relative "pili/rpc"
+require_relative "pili/client"
+require_relative "pili/hub"
+require_relative "pili/stream"

data/pili.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pili/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "piliv2"
+  spec.version       = Pili::VERSION
+  spec.authors       = ["Pili Engineer"]
+  spec.email         = ["pili@qiniu.com"]
+  spec.summary       = %q{Pili Streaming Cloud Server-Side Library For Ruby.}
+  spec.description   = %q{Pili Streaming Cloud Server-Side Library For Ruby.}
+  spec.homepage      = "https://github.com/pili-engineering/pili-sdk-ruby"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: piliv2
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Pili Engineer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Pili Streaming Cloud Server-Side Library For Ruby.
+email:
+- pili@qiniu.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- example/example.rb
+- lib/pili.rb
+- lib/pili/auth.rb
+- lib/pili/client.rb
+- lib/pili/config.rb
+- lib/pili/exception.rb
+- lib/pili/hub.rb
+- lib/pili/rpc.rb
+- lib/pili/stream.rb
+- lib/pili/version.rb
+- pili.gemspec
+homepage: https://github.com/pili-engineering/pili-sdk-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Pili Streaming Cloud Server-Side Library For Ruby.
+test_files: []