nicoscraper 0.2.3 → 0.2.4

data/README.md

@@ -1,112 +1,211 @@
-#どんなライブラリか
-　ニコニコ動画から動画およびマイリスト情報を取得し、その情報に対して各種操作を行えます。タグやマイリスト検索結果からの抽出、および抽出結果に対する反復処理を行うメソッドも備え、ランキングサイト等の制作を支援します。
+NicoScraper
+====================
+
+**My site:**  [http://hdemon.net](http://hdemon.net)  
+**GitHub:**  [http://github.com/hdemon/nicoscraper](http://github.com/hdemon/nicoscraper)   
+**Author:**  Masami Yonehara  
+**Copyright:**  2011  
+**License:**  MIT License  
+**Latest Version:**  0.2.2  
+**Release Date:**  Sep 23rd 2011  
+ 
+
+何をするライブラリ？
+------
+
+　ニコニコ動画の動画ページ、検索ページ、あるいはそのAtomフィードから情報を取得し、その情報に対して各種操作を行えます。タグやマイリスト検索結果からの抽出、および抽出結果に対する反復処理を行うメソッドも備え、ランキングサイト等の制作を支援します。
+
+インストール
+------
+　Ruby 1.9.2以外には、特に必要とするものはありません。
+
+    $ gem install nicoscraper
+
+　とした後、
+
+    require 'nicoscraper' 
+
+　で使い始めて下さい。
+
+基本的な使い方
+------
 
-#簡単な概要
 　Movieクラス、Mylistクラス、Searcherモジュールから主要な機能が構成されています。基本的には、動画やマイリストのIDを指定してインスタンスを作り、そこから詳細な情報を取得するためのメソッドを実行したのち、さらに分析や加工を行う別のメソッドを実行する、という手順を踏みます。
 
-##動画情報の取得
+###動画情報の取得
 
 　例えば"sm1097445"という動画IDから、タイトルや動画の長さ、現在の閲覧数等の詳細な情報を知りたいときは、
 
-~~~~
-require 'nicoscraper'
-
-movie = Nicos::Movie::new("sm1097445")
-movie.getInfo
-
-p movie
-
-<Nicos::Movie:0x00000002537aa8
-	@video_id="sm1097445", 
-	@available=false, @title="【初音ミク】みくみくにしてあげる♪【してやんよ】", 
-	@description="おまえら、みっくみくにしてやんよ。歌詞はhttp://ikamo.hp.infoseek.co.jp/mikumiku.txt（9/20 1:55修正）。上げている他のもの→mylist/1450136", 
-	@thumbnail_url="http://tn-skr2.smilevideo.jp/smile?i=1097445", 
-	@first_retrieve=1190218922, 
-	@length=99, 
-	@movie_type="flv", 
-	@size_high=3906547, 
-	@size_low=1688098, 
-	@view_counter=9073614, 
-	@comment_num=2553366, 
-	@mylist_counter=183470, 
-	@last_res_body="★███████████☆ ☆████████████●●●●███ ★█████... ", 
-	@watch_url="http://www.nicovideo.jp/watch/sm1097445", @thumb_type="video", 
-	@embeddable=1, 
-	@no_live_play=0, 
-	@tags_jp=["音楽", "初音ミク", "みくみくにしてあげる♪", "ミクオリジナル曲", "ika", "VOCALOID殿堂入り", "元気が出るミクうた", "VOCALOID", "初音ミク名曲リンク", "深夜みっく"], 
-	@tags_tw=["彈幕強大", "把你MikuMiku掉♪", "週刊vocaloid排行榜第1名獲得曲", "翻譯歌曲", "台灣VOCALOID評論人氣曲", "最強彈幕傳說", "初音未來"], 
-	@user_id=70391 >
-
-~~~~
-
-　このように、Movieクラスのインスタンス（以下「動画インスタンス」）のgetInfoメソッドを利用します。その結果、動画インスタンスにインスタンス変数として各種情報が付加されます。
-
-##マイリスト情報の取得
+    require 'nicoscraper'
+
+    movie = Nicos::Movie::new("sm1097445")
+    movie.getInfo
+
+    p movie
+
+　Movieクラスのインスタンス（以下「動画インスタンス」）を動画IDを与えて生成した後、getInfoメソッドを利用します。その結果、
+
+    <Nicos::Movie:0x00000002537aa8
+      @video_id="sm1097445", 
+      @available=false, 
+      @title="【初音ミク】みくみくにしてあげる♪【してやんよ】", 
+      @description="おまえら、みっくみくにしてやんよ。歌詞は...", 
+      @thumbnail_url="http://tn-skr2.smile...", 
+      @first_retrieve=1190218922, 
+      @length=99, 
+      @movie_type="flv", 
+      @size_high=3906547, 
+      @size_low=1688098, 
+      @view_counter=9073614, 
+      @comment_num=2553366, 
+      @mylist_counter=183470, 
+      @last_res_body="★███████████☆...", 
+      @watch_url="http://www.nicovideo.jp/...", 
+      @thumb_type="video", 
+      @embeddable=1, 
+      @no_live_play=0, 
+      @tags_jp=["音楽", "初音ミク", ...], 
+      @tags_tw=["彈幕強大", "把你MikuMiku掉♪", ...], 
+      @user_id=70391 >
+　このように、動画インスタンスにインスタンス変数として各種情報が付加されます。
+
+###マイリスト情報の取得
+
 　Mylistクラスもほぼ同様ですが、Mylistクラスのインスタンス（以下「マイリストインスタンス」）は、マイリスト情報の他に、そのマイリストが含む動画のインスタンスを自動的に生成します。つまり、
 
-~~~~
-require 'nicoscraper'
-
-mylist = Nicos::Mylist::new("")
-mylist.getInfoLt
-
-p mylist
-
-# 結果
-#<Nicos::Mylist:0x00000002884670
-　@mylist_id=15196568,
-	@movies=[
-		#<Nicos::Movie:0x0000000255a968
-			@video_id="sm8481759", 
-			@available=true, @title="【Oblivion】おっさんの大冒険１（ゆっくり実況）",
-			...
-		#<Nicos::Movie:0x0000000251a6b0 
-			@video_id="sm8506034",
-		 	@available=true,
-		 	@title="【Oblivion】おっさんの大冒険２（ゆっくり実況）",
-		 	...
-	],
-	@available=true,
-	@title="【Oblivion】おっさんの大冒険", 
-	... >
-~~~~
-
-　というように、動画インスタンスを勝手につくりだして配列として保持します。
-
-##検索結果の取得
+    require 'nicoscraper'
+
+    mylist = Nicos::Mylist::new("")
+    mylist.getInfoLt
+
+    p mylist
+
+このように実行すると、
+
+    <Nicos::Mylist:0x00000002884670
+      @mylist_id=15196568,
+      @movies=[
+        #<Nicos::Movie:0x0000000255a968
+          @video_id="sm8481759", 
+          @available=true, 
+          @title="【Oblivion】おっさんの大冒険１（ゆっくり実況）",
+          ...
+        #<Nicos::Movie:0x0000000251a6b0 
+          @video_id="sm8506034",
+          @available=true,
+          @title="【Oblivion】おっさんの大冒険２（ゆっくり実況）",
+          ...
+      ],
+      @available=true,
+      @title="【Oblivion】おっさんの大冒険", 
+      ... >
+
+　というように、動画インスタンスを勝手につくりだして配列として保持します。もちろん、これらの動画インスタンスには独立した操作を加えられます。
+
+###検索結果の取得
 
 　タグやマイリスト検索結果からの情報取得には、Searcherモジュールを使います。情報のソート方法の指定、取得する範囲の制限が可能です。
 
-~~~~
-require 'nicoscraper'
+    require 'nicoscraper'
 
-t = Time.now
-ytd = Date::new(t.year, t.month, t.day) - 1
-yesterday = Time.local(ytd.year, ytd.month, ytd.day, 0, 0, 0).to_i
+    t = Time.now
+    ytd = Date::new(t.year, t.month, t.day) - 1
+    yesterday = Time.local(ytd.year, ytd.month, ytd.day, 0, 0, 0).to_i
 
-Searcher.byTag('ゆっくり実況プレイpart1リンク', 'post_new', nil) {
-  |result, page|
+    searcher = Nicos::Searcher::ByTag.new()
 
-	result.each { |e|
-    movie = Nicos::Movie.new(e['video_id'])
-    movie.getInfo
+    searcher.execute('ゆっくり実況プレイpart1リンク', 'post_new', nil) {
+      |result, page|
+
+      result.each { |movieObj|
+        puts movieObj.title +
+          " is posted at " +
+           Time.at(movieObj.first_retrieve).to_s
+
+        "continue" if movieObj.first_retrieve >= yesterday 
+      }  
+    }
+
+　この例では、'ゆっくり実況プレイpart1リンク'というタグの付く動画を、post_new=投稿日時が新しい順からさかのぼって取得し、取得した動画の日付が前日の0時0分を超えるまでそれを続けます。 
+
+　ブロック内の第1引数には取得結果に基づく動画インスタンスが与えられるのですが、これは32個分の配列です。なぜ32個のセットなのかと言うと、ご存知のようにニコニコ動画の検索画面はページで区切られており、Searcherモジュールの各メソッドはページ毎に情報を取得し、ページ単位でブロックをコールするからです。Htmlから取得するにしろAtomフィードから取得するにしろ、1ページに32個の動画情報が含まれています。そして、第2引数には現在のページ数が与えられます。
+
+　そして、ブロック内で"continue"を返すことによりスクレイプが継続します。つまり、"continue"を返し続けるロジックを組み込まないと、1ページ目を読んだ時点で処理が終了します。これは意図せざる過剰アクセスを防ぐための措置です。
+
+　上の例では、取得した動画の日付を調べ、3日前の0時0分より前の動画に到達すればそこでループを終える設計です。ループを終えるために取得情報を使うかどうかは任意なので、例えば10分間の制限で取得出来るだけ取得するということも可能でしょう。
+
+###取得した情報に対する操作
+
+　現在のところ、以下のような操作が可能です。詳しい使い方は、各メソッドの説明を参照して下さい。
+
+**動画の説明文からタイトルを取得する。**
+{Nicos::Movie#extrMylist Nicos::Movie::extrMylist}
+　動画の説明文中に、'mylist/...'という表記で投稿者がマイリストを提示している事があります。extrMylistはこれを全て取得し、配列として返します。
+
+
+**指定したマイリストに、自分自身が入っているかを調べる。**
+{Nicos::Movie#isBelongsTo Nicos::Movie::isBelongsTo}
+
+
+**そのマイリスト内に含まれる全ての動画の、タイトルの類似性を調べる。**
+{Nicos::Mylist#getSimilarity Nicos::Mylist::getSimilarity}
+　マイリストのシリーズ性を判定するために、マイリスト内の全ての動画の組み合わせで、タイトルの「編集距離」に基づく類似度を計算します。
+
+
+**その動画が属する、シリーズとみなせるマイリストのIDを返します。**
+{Nicos::Movie#isSeriesOf Nicos::Movie::isSeriesOf}
+　isBelongsToとgetSimiralityの組み合わせにより、ある動画の説明文中にマイリストの記載がある場合、そのマイリストがタイトルの類似性によるシリーズとみなせるならば、そのIDを返します。
+
+
+注意点、および免責事項
+------
+
+　それぞれのメソッドは大半がニコニコ動画へのアクセスを伴い、特にSearcherモジュールは継続的かつ無制限なアクセスを可能にするため、使用には十分注意して下さい。その点を考慮し、Searcherモジュールのデフォルトのウェイトはかなり大きめに設定してあります。
+
+　使用する際には、ご自分の責任においてウェイトを変更して下さい。**本ライブラリの使用によって発生した損害および法的な責任については、ライブラリのバグに起因するものを含め、一切の責任を負いかねます。**
+
+　なお、Htmlからスクレイプするメソッドよりも、Atomフィードを使うメソッドの方がニコニコ動画側の負荷が（たぶん）軽く、アクセス制限などは起こりにくくなっています。大半の情報はAtomフィードで取得できるため、そうでない情報を取得したい場合に限り、Htmlを利用するメソッドを使うべきでしょう。
+
+
+用語・用法
+------
+
+**動画インスタンス**
+Movieクラスのインスタンス
+
+**マイリストインスタンス**
+Mylistクラスのインスタンス
+
+**動画ID | video_id**
+ニコニコ動画の各動画に与えられる、sm|nmで始まる一意のID。
+
+**アイテムID | item_id**
+動画に与えられるもう一つの一意なIDであり、投稿日時と同じか非常に近いUNIX時間になっている。例えば、"【初音ミク】みくみくにしてあげる♪【してやんよ】"の動画IDはsm1097445であり、アイテムIDは1190218917である。このアイテムIDを日時に直すと、日本時間における2007年9月20日 1:21:57となるが、動画に投稿日時として表示されるのは、2007年9月20日 1:22:02である。
+
+
+今後の予定
+------
+
+**v0.3**
+
++ HTMLから取得・解析するメソッドの追加。
+
++ キーワード検索の実装
+
+**v0.4-**
 
-	  puts movie.title.toutf8 +
-      " is posted at " +
-       Time.at(movie.first_retrieve).to_s.toutf8
++ シリーズ性判定の強化。説明文中にある「次 sm***」等の表記を解析し、マイリストに頼らずにシリーズ性を判定するようにする。
 
-    true if movie.first_retrieve <= yesterday 
-  }  
-}
-~~~~
++ コミュニティ動画、限定公開動画・マイリストへの対応。
 
-　これは'ゆっくり実況プレイpart1リンク'というタグの付く動画を、post_new=投稿日時が新しい順からさかのぼって取得していき、取得した動画の日付が前日の0時0分を超えるまでそれを続けます。 
 
-　ブロック内の第1引数には取得結果が与えられるのですが、これは動画1つ毎のコールバックではなく、32個分の配列です。なぜ32個のセットなのかと言うと、ご存知のようにニコニコ動画の検索画面はページで区切られており、Searcherモジュールの各メソッドはページ毎に情報を取得するためです。Htmlから取得するにしろAtomフィードから取得するにしろ、1ページに32個の動画情報が含まれています。そして、第2引数にはそのページ数が与えられます。
+更新履歴
+------
 
-　なお、ブロック内でtrueを返すことによりスクレイプは終わります。逆に言えば、trueを返さない限り検索結果全ての情報を取得しようとするため、十分に注意して下さい。上の例では、取得した動画の日付を調べ、3日前の0時0分より前の動画があればそこでループを終える設計です。
+**v0.2.4**
 
++ ドキュメント作成
 
-#より詳しい情報
++ Searcherループのバグ修正。 
 
-は、こちらを御覧下さい。
++ Searcherループの継続判定を、ブロック内で"continue"を返す事を要求する方式に変更。

data/VERSION

@@ -1 +1 @@
-0.2.3
+0.2.4

data/lib/connector.rb

@@ -5,6 +5,8 @@ require 'rubygems'
 require 'ruby-debug'
 require 'net/http'
 
+require 'namespace.rb'
+
 module Nicos::Connector
   class Connector
     def initialize
@@ -124,7 +126,6 @@ module Nicos::Connector
     end
   end
 
-
   class Xml < Connector
     def get (host, entity)  
       response = nil
@@ -226,6 +227,7 @@ module Nicos::Connector
     end
   end
 
+=begin
   class HtmlConnector < Connector
     def initialize(mode)
       @mode = mode
@@ -355,7 +357,8 @@ module Nicos::Connector
       
       return @mech.page
     end
-
+    
     attr_reader :mech
   end
+=end
 end

data/lib/converter.rb

@@ -1,8 +1,12 @@
-require 'rubygems'
+# -*- encoding: utf-8 -*-
+$:.unshift File.dirname(__FILE__) 
+
+require 'rubygems'
 require 'xml'
 require 'time'
+require 'namespace.rb'
 
-module Nicos::Converter
+module Nicos::Converter #:nodoc:
   def iso8601ToUnix(str)
     Time.strptime(str, "%Y-%m-%dT%H:%M:%S").to_i
   end
@@ -30,7 +34,7 @@ module Nicos::Converter
   module_function :commaRemover
 end
 
-module Nicos::Extractor
+module Nicos::Extractor #:nodoc:
   def mylistId(str)
     /(mylist\/)([0-9]{1,})/ =~ str
     $2.to_i

data/lib/movie.rb

@@ -6,45 +6,54 @@ require 'ruby-debug'
 require 'damerau-levenshtein'
 require 'kconv'
 
+require 'namespace.rb'
 require 'parser.rb'
 require 'mylist.rb'
 require 'connector.rb'
 
 class Nicos::Movie  
+  # @param [video_id] video_id 動画ID
+  # インスタンス作成直後は、情報を取得しメソッドを実行する準備が整ったことを示す
+  # @availableがfalseである。getInfo等で情報を取得するか、あるいはsetメソッドで
+  # availableにtrueを代入する必要がある。
   def initialize(video_id)
     @video_id   = video_id
     @available  = false
   end
   
-  private
-   
   public
   
-  # 指定されたマイリストに自分が入っていれば、真を返す。  
+  # 指定されたマイリストに自分が入っていれば、真を返す。 
+  #
+  # 内部的にMylist::getInfoを利用しているため、もし指定したマイリストの他の情報を使いたければ、
+  # ブロック中に処理を記述することで、getInfoの取得結果を共用することができる。
+  # @param [Fixnum] mylistId マイリストID
+  # @return [Boolean] 
   def isBelongsTo (mylistId, &block)
     isBelongs = false
     thisMl = Nicos::Mylist.new(mylistId)
-    thisMl.getInfoLt
+    thisMl.getInfo
     
     thisMl.movies.each { |movie|
       isBelongs = true if movie.video_id == @video_id
     }   
   
     if isBelongs
-      puts "\sThis movie is found in mylist/" + mylistId.to_s
+      puts "\sThis movie is found in mylist/" + 
+        mylistId.to_s
     else
-      puts "\sThis movie is not found in mylist/" + mylistId.to_s
+      puts "\sThis movie is not found in mylist/" + 
+        mylistId.to_s
     end
-    
-    # 無駄なアクセスを省くため、マイリスト中の動画に関する追加処理があれば、
-    # ブロックとして実行できる。
-    block.call(thisMl) if block != nil
-    
-    return isBelongs
+
+    block.call(thisMl) if block != nil    
+    isBelongs
   end
   
   # 自分が含まれる、投稿者の作ったシリーズとしてまとめているマイリストのIDを返す。
-  # 情報取得元が異なるため、必ずしもisBelongsの結果とは包含関係にならない。
+  #
+  # isBelongsは指定されたマイリストとの関係を調べるが、isSeriesOfは動画説明文中のマイリストIDのみを用いる。
+  # @return [Fixnum] マイリストID
   def isSeriesOf
     if !@available then
       puts "This movie object is not available."
@@ -80,10 +89,12 @@ class Nicos::Movie
     }
     
     puts "\sDiscern logic terminated."
-    return mlObjAry   
+    mlObjAry   
   end
 
-  # 動画説明文中から、マイリストIDを示す文字列を抜き出す。
+  # 動画説明文中からマイリストIDを示す文字列を抽出し、配列として返す。
+  #
+  # @return [Array] マイリストIDを含む配列
   def extrMylist
     return if !@available
     puts "Extracting mylistId from the description..."
@@ -100,9 +111,13 @@ class Nicos::Movie
       puts "\sMylistId is not found."
     end  
     
-    return mylistIdAry
+    mylistIdAry
   end
   
+  # 動画の詳細な情報を取得し、インスタンス変数に納める。
+  # 
+  # 内部的にgetThumbInfo APIを利用。
+  # @return [Boolean] 成功すればtrueを返す。
   def getInfo
     con = Nicos::Connector::GetThumbInfo.new()
     host = 'ext.nicovideo.jp'
@@ -115,50 +130,60 @@ class Nicos::Movie
     then
       parsed = Nicos::Parser::getThumbInfo(result["body"])
       set(parsed)
-      p self
       @available = true
     else
       @available = false
     end
   end
-    
+  
+  # インスタンスに対し、任意の情報を入れる。
+  #
+  # @param [HashObj] paramObj getThumbInfo等から手に入れたハッシュ
+  # getInfo等を利用せずインスタンス変数に直接情報を入れる場合、もしgetThumbInfoやMylist APIからXMLやJSONで取得し、
+  # 特にキー名を変更していないハッシュオブジェクトがあるのであれば、setメソッドで一括代入することができる。
+  #
+  # なお、getThumbInfoや、マイリストAtomフィードなどの情報は、取得元になるXML等のタグ名が少しずつ異なるため、
+  # setメソッドに渡すべきハッシュオブジェクトのキー名は、必ずしもインスタンス変数の名前とは一致しない。
+  # 例えば、getThumbInfoは現在のコメント数をcomment_numというタグで示すが、
+  # マイリストのAtomフィードはnico-numbers-resというクラス名のタグで囲んでいる。
   def set(paramObj)
     paramObj.each_key { |key|
       param = paramObj[key]
       case key
       when "available"
         @available = param
-        
+       
+      # common  
       when "video_id"
-        @video_id = param
+        @video_id = param.to_s
+      when "item_id"
+        @item_id = param.to_i
+      when "title"
+        @title = param.to_s
       when "mylist_id"    
-        @mylist_id = param
-    	when "item_id"
-        @item_id = param
+        @mylist_id = param.to_i
     	when "description"
-        @description = param
+        @description = param.to_s   
+      when "length"
+        @length = param.to_i   
+      when "first_retrieve"
+        @first_retrieve = param       
       
-      # MylistAPI
-      when "video_id"
-        @video_id = param
-    	when "item_id"
-        @item_id = param.to_i
-    	when "description"
-        @description = param        
+      # MylistAPI      
       when "item_data"
         paramObj['item_data'].each_key { |key|
         param = paramObj['item_data'][key]
           case key
           when "video_id"
-            @video_id = param   
+            @video_id = param.to_s  
         	when "title"
-            @title = param
+            @title = param.to_s
         	when "thumbnail_url"
-            @thumbnail_url = param
+            @thumbnail_url = param.to_s
         	when "first_retrieve"
-            @first_retrieve = param
+            @first_retrieve = param.to_i
         	when "update_time"
-            @update_time = param
+            @update_time = param.to_i
         	when "view_counter"
             @view_counter = param.to_i
         	when "mylist_counter"
@@ -166,132 +191,328 @@ class Nicos::Movie
         	when "num_res"
             @comment_num = param.to_i
         	when "length_seconds"
-            @length = param
+            @length = param.to_i
         	when "deleted"
             @deleted = param.to_i       
         	when "last_res_body"
-            @last_res_body = param
+            @last_res_body = param.to_s
           end
         } 
     	when "watch"
-        @watch = param
+        @watch = param.to_i
     	when "create_time"
-        @create_time = param
+        @create_time = param.to_i
     	when "update_time"
-        @update_time = param
+        @update_time = param.to_i
       
       # MylistAPI-Atom
-      when "video_id"
-        @video_id = param
-    	when "item_id"
-        @item_id = param
     	when "memo"
-        @memo = param        
+        @memo = param.to_s       
     	when "published"
-        @published = param       
+        @create_time = param.to_i     
     	when "updated"
-        @updated = param    
-    	when "thumbnail_url"
-        @thumbnail_url = param     
-    	when "length"
-        @length = param
-    	when "view"
+        @update_time = param.to_i 
+      when "view"
         @view_counter = param.to_i
-    	when "mylist"
+      when "mylist"
         @mylist_counter = param.to_i
-    	when "res"
-        @comment_num = param.to_i     
-    	when "first_retrieve"
-        @first_retrieve = param       
-    	when "length"
-        @length = param        
+      when "res"
+        @comment_num = param.to_i       
       
       # getThumbInfo  
-      when "video_id"
-        @video_id = param   
-    	when "title"
-        @title = param
-    	when "description"
-        @description = param  
     	when "thumbnail_url"
-        @thumbnail_url = param
-    	when "first_retrieve"
-        @first_retrieve = param
-    	when "length"
-        @length = param
+        @thumbnail_url = param.to_s
     	when "movie_type"
-        @movie_type = param
+        @movie_type = param.to_s
       when "size_high"
-        @size_high = param
+        @size_high = param.to_i
     	when "size_low"
-        @size_low = param
+        @size_low = param.to_i
     	when "view_counter"
-        @view_counter = param
+        @view_counter = param.to_i
     	when "mylist_counter"
-        @mylist_counter = param
+        @mylist_counter = param.to_i
     	when "comment_num"
-        @comment_num = param
+        @comment_num = param.to_i
     	when "last_res_body"
-        @last_res_body = param
+        @last_res_body = param.to_s
     	when "watch_url"
-        @watch_url = param
+        @watch_url = param.to_s
     	when "thumb_type"
-        @thumb_type = param
+        @thumb_type = param.to_s
     	when "embeddable"
-        @embeddable = param
+        @embeddable = param.to_i
     	when "no_live_play"
-        @no_live_play = param
+        @no_live_play = param.to_i
     	when "tags_jp"
         @tags_jp = param
       when "tags_tw"
         @tags_tw = param
     	when "tags_de"
         @tags_de = param
-      when "tags_sp"
+      when "tags_es"
         @tags_sp = param
     	when "user_id"
-        @user_id = param
+        @user_id = param.to_i
       end
     }   
   end  
   
+  # このインスタンスがgetInfo等によって正常に情報を取得できている場合、trueとなる。
+  # 各種メソッドの実行には、これがtrueであることが要求される。
+  # 
+  # @return [Boolean]
   attr_accessor :available
   
-  # MylistAPI   
+  # MylistAPI
+  
+  # 動画に付与される、sm|nmで始まる一意のID 
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}  
   attr_accessor	:video_id
+
+  # この動画が属するマイリストのID  
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}  
   attr_accessor	:mylist_id
+
+  # 動画に与えられるもう一つの一意なIDであり、投稿日時と同じか非常に近いUNIX時間になっている。
+  #
+  # 例えば、"【初音ミク】みくみくにしてあげる♪【してやんよ】"の動画IDはsm1097445であり、アイテムIDは1190218917である。このアイテムIDを日時に直すと、日本時間における2007年9月20日 1:21:57となるが、動画に投稿日時として表示されるのは、2007年9月20日 1:22:02である。
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}  
   attr_accessor	:item_id
+  
+  # 投稿者が記述した動画の説明文
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}  
   attr_accessor	:description
 
+  # 動画のタイトル
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:title
+
+  # サムネイルのURL
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:thumbnail_url
+
+  # 動画の投稿日
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:first_retrieve
-  attr_accessor	:update_time
+
+  # 取得時の再生数
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:view_counter
+
+  # 取得時のマイリスト数
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:mylist_counter
+
+  #　取得時のコメント数
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:comment_num
+
+  # 動画の長さ（秒）
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:length
+
+  # 削除されたかどうか。削除済みの場合は1、そうでなければ0。
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:deleted
+
+  # 最新のコメント
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:last_res_body
 
+  # ?
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:watch
+
+  # 動画の投稿日に近いが、若干こちらの方が遅い。詳細不明。
+  #
+  # マイリストHTML中JSオブジェクトの"create_time"、マイリストAtomフィードにおける<published>に対応。
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor	:create_time
-  attr_accessor	:update_time
 
+  # 動画の更新日？
+  #
+  # マイリストHTML中JSオブジェクトの"update_time"、マイリストAtomフィードにおける<updated>に対応。
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
+  attr_accessor :update_time
   # MylistAPI-Atom
+
+  # マイリストの動画紹介欄に記載される説明文
+  # 
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  # {Nicos::Movie#getInfo Mylist::getInfo}  
+  # {Nicos::Movie#getInfo Mylist::getHtmlInfo}
   attr_accessor :memo
-  attr_accessor	:published
-  attr_accessor	:updated
+
   
   # getThumbInfo
+
+  # 動画ファイルの種類。
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
   attr_accessor	:movie_type
+
+  # 高画質時の動画サイズ？
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
   attr_accessor	:size_high
+
+  # 低画質時の動画サイズ？
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
   attr_accessor	:size_low
+
+  # 動画の閲覧URL
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
   attr_accessor	:watch_url
+
+  # ？
+  #
+  # @return [String]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
   attr_accessor	:thumb_type
-  attr_accessor	:embeddable
-  attr_accessor	:no_live_play
+
+  # ブログ等に埋め込み、ログインなしでも閲覧できるかどうか。可能なら1。
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  attr_accessor :embeddable
+
+  # ニコニコ生放送の拒否？
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
+  attr_accessor :no_live_play
+
+  # 日本語タグ
+  #
+  # @return [Array<String>]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
   attr_accessor	:tags_jp
+
+  # 台湾タグ
+  #
+  # @return [Array<String>]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
   attr_accessor	:tags_tw
+
+  # ユーザID
+  #
+  # @return [Fixnum]
+  # <b>取得可能なメソッド</b>  
+  # {Nicos::Movie#getInfo Movie::getInfo}  
+  # {Nicos::Movie#getInfo Movie::getHtmlInfo}  
   attr_accessor	:user_id
+
 end