Oynatıcı Parametreleri

Genel Bakış

Bu belge, bir YouTube oynatıcısını uygulamanıza nasıl yerleştireceğinizi açıklar ve aynı zamanda yerleştirilmiş YouTube oynatıcısında mevcut olan parametreleri tanımlar.

Parametreleri IFrame sine ekleyerek uygulamanızdaki oynatma deneyimini özelleştirebilirsiniz. Örneğin, autoplay parametresini kullanarak videoları otomatik oynatabilir veya loop parametresini kullanarak videonun tekrar tekrar oynatılmasını sağlayabilirsiniz. enablejsapi parametresini kullanarak oynatıcı için JavaScript API'sını da etkinleştirebilirsiniz.

Bu sayfa, şu anda tüm yerleştirilmiş YouTube oynatıcılarında desteklenen parametrelerin tümünü tanımlamaktadır. Her bir parametre tanımı, karşılık gelen parametreyi destekleyen oynatıcıları tanımlar.

Not: Yerleşik oynatıcıların en az 200 piksele 200 piksel değerinde bir görünüme sahip olması gerekir. Oynatıcı kontrolleri gösterirse görünümün minimum boyutun altına düşürmeksizin kontrolleri tamamen gösterecek kadar geniş olması gerekir. En az 480 piksel genişlik, 270 piksel uzunluğa sahip 16:9 oynatıcıları öneririz.

YouTube oynatıcısı yerleştirme

Uygulamanıza bir YouTube oynatıcısı yerleştirmek ve oynatıcı parametrelerini belirlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz. Aşağıdaki talimatların tek video yükleyen bir oynatıcının nasıl yerleştirildiğini gösterdiğini unutmayın. Aşağıdaki bölüm, oynatıcınızı oynatma listeleri ve arama sonuçları gibi diğer içerik türlerini yükleyecek şekilde nasıl yapılandıracağınızı açıklar.

`<iframe>` etiketleriyle IFrame yerleştirmeleri

src URL'sinin oynatıcının yükleyeceği içeriklerin yanı sıra ayarlamak istediğiniz diğer oynatıcı parametrelerini belirttiği uygulamanızda bir <iframe> etiketi tanımlayın. <iframe> etiketinin height ve width parametreleri, oynatıcının boyutlarını belirtir.

<iframe> öğesini kendiniz oluşturuyorsanız (IFrame Player API'sını kullanmak yerine) oynatıcı parametrelerini doğrudan URL'nin sonuna ekleyebilirsiniz. URL şu biçimdedir:

http://www.youtube.com/embed/VIDEO_ID

Aşağıdaki <iframe> etiketi, M7lc1UVf-VE YouTube videosunu oynatacak bir 640x360 piksellik oynatıcı yükler. URL autoplay parametresini 1 olarak ayarladığından oynatıcı yüklendikten sonra video otomatik olarak oynatılır.

<iframe id="ytplayer" type="text/html" width="640" height="360"
  src="http://www.youtube.com/embed/M7lc1UVf-VE?autoplay=1&origin=http://example.com"
  frameborder="0"/>

IFrame Player API'sı ile IFrame yerleştirmeleri

Player API'sının JavaScript kodu yüklendikten sonra web sayfanıza veya uygulamanıza bir video oynatıcısı eklemek için IFrame Player API'sı talimatlarını uygulayın. Video oynatıcısını oluşturan ikinci parametre, oynatıcı seçeneklerini belirten bir nesnedir. Bu nesnenin içinde, playerVars özelliği oynatıcı parametrelerini tanımlar.

Aşağıdaki HTML ve JavaScript kodu, bir YouTube oynatıcısının ytplayer öğesinin id değerine sahip bir sayfa öğesine yerleştirildiği basit bir örneği göstermektedir. Burada belirtilen onYouTubePlayerAPIReady() işlevi, IFrame Player API'sı kodu yüklendiğinde otomatik olarak çağrılır. Bu kod, herhangi bir oynatıcı parametresini ve diğer etkinlik işleyicileri tanımlamaz.

<div id="ytplayer"></div>

<script>
  // Load the IFrame Player API code asynchronously.
  var tag = document.createElement('script');
  tag.src = "https://www.youtube.com/player_api";
  var firstScriptTag = document.getElementsByTagName('script')[0];
  firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);

  // Replace the 'ytplayer' element with an <iframe> and
  // YouTube player after the API code downloads.
  var player;
  function onYouTubePlayerAPIReady() {
    player = new YT.Player('ytplayer', {
      height: '360',
      width: '640',
      videoId: 'M7lc1UVf-VE'
    });
  }
</script>

Oynatılacak içerikleri seçme

Yerleştirilmiş oynatıcınızı bir videoyu, oynatma listesini, kullanıcı tarafından yüklenen videoları veya belirli bir sorgu için arama sonuçlarını yükleyecek şekilde yapılandırabilirsiniz.

Aşağıdaki listede bu seçenekler açıklanmaktadır:

Video yükleme

Bir IFrame yerleştirmesi için yüklemek istediğiniz videonun YouTube video kimliği, IFrame'in src URL'sinde belirtilir.
```
http://www.youtube.com/embed/VIDEO_ID
```
YouTube Data API'sını (v3) kullanıyorsanız arama sonuçlarından, oynatma listesi öğesi kaynaklarından, video kaynaklarından veya diğer kaynaklardan video kimlikleri alarak bu URL'leri program kodları yoluyla oluşturabilirsiniz. Bir video kimliği elde ettikten sonra oynatıcı URL'sini oluşturmak için yukarıdaki URL'lerde bulunan VIDEO_ID metnini bu değerle değiştirin.
Oynatma listesi yükleme

listType oynatıcı parametresini playlist olarak ayarlayın. Ayrıca, list oynatıcı parametresini yüklemek istediğiniz YouTube oynatma listesi kimliğine ayarlayın.
```
http://www.youtube.com/embed?listType=playlist&list=PLAYLIST_ID
```
PL harflerine sahip oynatma listesi kimliğini aşağıdaki örnekte gösterildiği şekilde en başa eklemeniz gerektiğini unutmayın:
```
http://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6
```
YouTube Data API'sını (v3) kullanıyorsanız arama sonuçlarından, kanal kaynaklarından veya etkinlik kaynaklarından oynatma listesi kimlikleri alarak bu URL'leri program kodları yoluyla oluşturabilirsiniz. Bir oynatma listesi kimliği elde ettikten sonra yukarıdaki URL'de bulunan PLAYLIST_ID metnini o değerle değiştirin.
Bir kullanıcının yüklediği videoları yükleme

listType oynatıcı parametresini user_uploads olarak ayarlayın. Ayrıca, list oynatıcı parametresini yüklenmiş videolarını yüklemek istediğiniz YouTube kullanıcı adına ayarlayın.
```
http://www.youtube.com/embed?listType=user_uploads&list=USERNAME
```
Belirtilen bir sorgu için arama sonuçlarını yükleme

listType oynatıcı parametresini search olarak ayarlayın. Ayrıca, list oynatıcı parametresini oynatıcının arama sonuçlarını yüklemesini istediğiniz sorgu terimine ayarlayın.
```
http://www.youtube.com/embed?listType=search&list=QUERY
```

Parametreler

Aşağıdaki parametrelerin tümü isteğe bağlıdır.

Parameters
`autoplay`	Değerler: `0` veya `1`. `0` varsayılandır. Oynatıcı yüklendiğinde ilk videonun otomatik oynatılıp oynatılmayacağını ayarlar.
`cc_load_policy`	Değerler: `1`. Varsayılan değer, kullanıcının tercihine bağlıdır. `1` olarak ayarlamak, kullanıcı altyazıları kapatmış olsa bile altyazıların varsayılan olarak gösterilmesine neden olur.
`color`	Bu parametre, oynatıcının video ilerleme çubuğunda görüntüleyenin videoda izlediği süreyi vurgulamak için kullanılacak rengi belirtir. Geçerli parametre değerleri `red` ve `white` şeklindedir ve oynatıcı varsayılan olarak video ilerleme çubuğunda kırmızı rengini kullanır. Renk seçenekleriyle ilgili daha fazla bilgi için YouTube API'sı bloguna bakın. Not: `color` parametresini `white` olarak ayarlamak, `modestbranding` seçeneğini devre dışı bırakır.
`controls`	Değerler: `0`, `1` veya `2`. `1` varsayılandır. Bu parametre, video oynatıcısı kontrollerinin gösterilip gösterilmeyeceğini belirtir. Bir Flash oynatıcı yükleyen IFrame yerleştirmeleri için bu aynı zamanda kontrollerin oynatıcıda ne zaman gösterileceğinin yanı sıra oynatıcının ne zaman yükleneceğini de tanımlar: `controls=0` – Oynatıcı kontrolleri oynatıcıda gösterilmez. IFrame yerleştirmeleri için Flash oynatıcı anında yüklenir. `controls=1` – Oynatıcı kontrolleri oynatıcıda gösterilir. IFrame yerleştirmeleri için kontroller anında gösterilir ve Flash oynatıcı anında yüklenir. `controls=2` – Oynatıcı kontrolleri oynatıcıda gösterilir. IFrame yerleştirmeleri için kontroller gösterilir ve Flash oynatıcı, kullanıcı video oynatmayı başlattıktan sonra yüklenir. Not: `1` ve `2` parametre değerleri, benzer bir kullanıcı deneyimi sunmaya yöneliktir. Ancak `controls=2`, IFrame yerleştirmeleri için `controls=1` üzerinde bir performans iyileştirmesi sunar. Bu iki değer, şu anda oynatıcıda video başlığının yazı boyutu gibi bazı görsel farklılıklar üretmeye devam etmektedir. Ancak, iki değer arasındaki farklılıklar kullanıcı tarafından tamamen görülmez olduğunda varsayılan parametre değeri `1` değerinden `2` değerine değişebilir.
`disablekb`	Değerler: `0` veya `1`. `0` varsayılandır. `1` olarak ayarlamak, oynatıcı klavye kontrollerini devre dışı bırakır. Klavye kontrolleri şöyledir: Boşluk Çubuğu: Oynat / Duraklat Sol Ok: Geçerli videoda %10 geri git Sağ Ok: Geçerli videoda %10 ileri git Yukarı Ok: Sesi artır Aşağı Ok: Sesi azalt
`enablejsapi`	Değerler: `0` veya `1`. `0` varsayılandır. Bunun `1` olarak ayarlanması, Javascript API'sını etkinleştirir. Javascript API'sı ve nasıl kullanılacağıyla ilgili daha fazla bilgi için JavaScript API'sı belgelerine bakın.
`end`	Değerler: Pozitif bir tam sayı. Bu parametre, videonun başlangıcından itibaren saniyelerle ölçülen, oynatıcının videoyu oynatmayı durdurması gereken zamanı belirtir. Bu zamanın videonun başlangıcından beri ölçüldüğünü ve `start` oynatıcı parametresi ya da YouTube Oynatıcısı API'sının bir videoyu yükleme veya sıraya alma işlevlerinde kullanılan `startSeconds` parametresinden itibaren ölçülmediğini unutmayın.
`fs`	Değerler: `0` veya `1`. Varsayılan değer `1`, tam ekran düğmesinin gösterilmesine neden olur. Bu parametrenin `0` olarak ayarlanması, tam ekran düğmesinin gösterilmesini engeller.
`hl`	Oynatıcının arayüz dilini ayarlar. Parametre değeri bir ISO 639-1 iki harfli dil kodudur, ancak IETF dil etiketleri (BCP 47) gibi diğer dil giriş kodları da düzgün şekilde işlenebilir. Bu arayüz dili, oynatıcıdaki araç ipuçları için kullanılır ve varsayılan altyazı parçasını da etkiler. YouTube'un kullanıcının bireysel dil tercihlerine ve altyazı parçalarının mevcutluğuna göre belirli bir kullanıcı için farklı bir altyazı dili seçebileceğini unutmayın.
`iv_load_policy`	Değerler: `1` veya `3`. `1` varsayılandır. `1` olarak ayarlamak video ek açıklamalarının varsayılan olarak gösterilmesine neden olurken, `3` olarak ayarlamak video ek açıklamalarının varsayılan olarak gösterilmemesine neden olur.
`list`	`list` parametresi, `listType` parametresiyle birlikte, oynatıcıda yüklenecek içeriği tanımlar. `listType` parametre değeri `search` ise `list` parametre değeri, arama sorgusunu belirtir. `listType` parametre değeri `user_uploads` ise `list` parametre değeri, yüklenmiş videoları yüklenecek YouTube kanalını tanımlar. `listType` parametre değeri `playlist` ise `list` parametre değeri bir YouTube oynatma listesi kimliğini belirtir. Parametre değerinin başına, `PL` harflerine sahip oynatma listesi kimliğini aşağıdaki örnekte görüldüğü gibi eklemeniz gerekir. http://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6 Not: `list` ve `listType` parametreleri için değer belirtirseniz IFrame yerleştirme URL'sinin bir video kimliği belirtmesi gerekmez.
`listType`	`listType` parametresi, `list` parametresiyle birlikte oynatıcıda yüklenecek içeriği tanımlar. Geçerli parametre değerleri: `playlist`, `search` ve `user_uploads`. `list` ve `listType` parametreleri için değer belirtirseniz IFrame yerleştirme URL'sinin bir video kimliği belirtmesi gerekmez.
`loop`	Değerler: `0` veya `1`. `0` varsayılandır. Tek bir video oynatıcısı durumunda `1` ayarı, oynatıcının ilk videoyu tekrar tekrar oynatmasına neden olur. Bir oynatma listesi oynatıcısı (veya özel oynatıcı) durumunda oynatıcı, tüm oynatma listesini oynatır ve ilk videodan baştan başlar. Not: Bu parametrenin AS3 oynatıcısı ve AS3 veya HTML5 oynatıcıyı yükleyebilen IFrame yerleştirmeleri desteği sınırlıdır. Şu anda `loop` parametresi, `playlist` parametresiyle birlikte kullanıldığında yalnızca AS3 oynatıcısında çalışmaktadır. Tek bir videoyu döndürmek için `loop` parametre değerini `1` olarak, `playlist` parametre değerini ise Oynatıcı API URL'sinde önceden belirtilmiş aynı video kimliğine ayarlayın. http://www.youtube.com/v/VIDEO_ID?version=3&loop=1&playlist=VIDEO_ID
`modestbranding`	Bu parametre, YouTube logosunu göstermeyen bir YouTube oynatıcısını kullanmanıza izin verir. YouTube logosunun kontrol çubuğunda gösterilmesini önlemek için parametre değerini `1` olarak ayarlayın. Kullanıcının fare imleci oynatıcının üzerine geldiğinde duraklatılmış bir videonun sağ üst köşesinde küçük bir `YouTube` metin etiketinin gösterilmeye devam edeceğini unutmayın.
`origin`	Bu parametre, IFrame API'sı için fazladan güvenlik önlemi sağlar ve yalnızca IFrame yerleştirmeleri için desteklenir. IFrame API'sını kullanıyorsanız, yani `enablejsapi` parametre değerini `1` olarak ayarlıyorsanız etki alanınızı her zaman `origin` parametre değeri şeklinde belirtmeniz gerekir.
`playlist`	Değer, oynatılacak video kimliklerinin virgülle ayrılmış bir listesidir. Bir değer belirtirseniz oynatılan ilk video, URL yolunca belirtilen `VIDEO_ID` olur ve `playlist` parametresinde belirtilen videolar daha sonra oynatılır.
`playsinline`	Bu parametre, videoların iOS üzerindeki bir HTML5 oynatıcısında satır içinde mi yoksa tam ekran olarak mı oynatılacağını kontrol eder. Geçerli değerler şunlardır: `0`: Bu değer, tam ekran oynatmaya neden olur. Şu anda varsayılan değer budur, ancak değişime tabidir. `1`: Bu değer, `allowsInlineMediaPlayback` özelliği `TRUE` olarak ayarlı şekilde oluşturulmuş `UIWebViews` öğesi için satır içi oynatmaya neden olur.
`rel`	Değerler: `0` veya `1`. `1` varsayılandır. Bu parametre, ilk videonun oynatılması sona erdiğinde oynatıcının ilgili videoları göstermesinin gerekip gerekmediğini ifade eder.
`showinfo`	Değerler: `0` veya `1`. `1` bu parametrenin varsayılan değeridir. Parametre değerini `0` olarak ayarlarsanız oynatıcı, video oynatılmaya başlamadan önce video başlığı ve yükleyici gibi bilgileri göstermez. Oynatıcı bir oynatma listesi yüklüyorsa ve parametre değerini açıkça `1` olarak ayarladıysanız yükleme sırasında oynatıcı, oynatma listesindeki videolar için de küçük resimleri gösterir. Bu işlevin, bir oynatma listesi yükleyebilecek tek oynatıcı olduğundan yalnızca AS3 oynatıcısı için desteklendiğini unutmayın.
`start`	Değeler: Pozitif bir tam sayı. Bu parametre, oynatıcının videoyu videonun başlangıcından itibaren belirlenen bir saniyede oynatmaya başlamasına neden olur. `seekTo` işlevine benzer olarak, oynatıcının belirttiğiniz zamana en yakın kareyi arayacağını unutmayın. Bu, oynatma başının bazen istenen zamandan çok az önce, genellikle iki saniyeden fazla olmayacak şekilde arayabileceği anlamına gelir.

Düzeltme geçmişi

October 14, 2014

The HTML5 player now supports the cc_load_policy, disablekb, end, fs, list, and listType parameters. The parameter descriptions have been updated accordingly.

July 18, 2014

The new hl parameter can be used to set the player's interface language. The interface language is used for tooltips in the player and also affects the default caption track. The selected caption track may also depend on the availability of caption tracks and user's individual language preferences.

The parameter's value is an ISO 639-1 two-letter language code, though other language input codes, such as IETF language tags (BCP 47) may also be handled properly.
The definition of the playsinline parameter, which only affects HTML5 players on iOS, has been modified slightly. The definition now notes that setting the parameter value to 1 causes inline playback only for UIWebViews created with the allowsInlineMediaPlayback property set to TRUE.