Sorry, it was my mistake calling it "$sublanguageid". It's just the language of the subtitle that a user or application uploaded.
So when I call CheckMovieHash( $token, $moviehash) it returns the first found hash (right?) of all the hashes which are found for *all* languages (if i am not mistaken).
For example: if you call this: CheckMovieHash( token, "a94c9aeacd0288d2") you will see that while the actual movie in this video file is "The Dark Knight", the movie this function returns is "Batman: Gotham Knight" which obviously is the wrong film.
Now, if it was possible to call something like this instead: CheckMovieHash($token, $moviehash, $language) and we called for an example CheckMovieHash( token, "a94c9aeacd0288d2", "eng" ), our function would only return the mathces that are contained *only* in English subtitle uploads, thus greatly reducing the probability of returning a wrong movie.
Hope it's more clear now.
Thanks again, and no worries about when the AddMovieHash function will be completed.
Looking forward for TV series support too!
edit: A better example to illustrate how the CheckMovieHash function can fail in enough cases to provide the correct IMDb Id:
For the "Heroes" tv series for the episode "One of Us, One of Them" , if you have the hash of the .avi file which is "53fc6fe84ad5ee31" and you search by this hash using the CheckMovieHash method, it will return the episode "Chapter Two 'The Butterfly Effect' " which is the wrong episode.
But if you search with this method in the browser:
http://www.opensubtitles.org/en/search2 ... eid-[b]eng[/b]/moviehash-53fc6fe84ad5ee31
... the search results will include the correct episode!
In many other cases for TV series, if one doesn't search by english or other language that have regural releases updates, the TV Series name will be correctly assumed, but the episode name will not be provided because the IMDb ID which this hash refers to is old, before IMDb provided a seperate page for each individual epsiode. Example:
http://www.imdb.com/title/tt0813715/
Now, i have discovered that SubDownloader actually gets the correct episode information but i'm wondering how it does this without the CheckMovieHash function supporting language preference?