事前準備

本頁說明如何建立 Google Cloud 專案、啟用 Live Stream API、建立驗證憑證，以及為帳戶授予一或多個 IAM 角色。本頁面也會說明如何建立 Cloud Storage bucket 來保存直播輸出檔案，以及如何安裝編碼器來產生 API 處理的輸入串流。

建立專案

  1. 登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自體驗產品的實際應用成效。新客戶還能獲得價值 $300 美元的免費抵免額，能用於執行、測試及部署工作負載。

  2. 安裝 Google Cloud CLI。

  3. 若您採用的是外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  4. 執行下列指令，初始化 gcloud CLI：

    gcloud init

  5. 建立或選取 Google Cloud 專案。

    選取或建立專案所需的角色

    • 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
    • 建立專案：如要建立專案，您需要專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

    • 建立 Google Cloud 專案：

      gcloud projects create PROJECT_ID

      將 PROJECT_ID 替換為要建立的專案名稱。 Google Cloud

    • 選取您建立的 Google Cloud 專案：

      gcloud config set project PROJECT_ID

      將 PROJECT_ID 替換為 Google Cloud 專案名稱。

  6. 確認 Google Cloud 專案已啟用計費功能。

  7. 如果尚未啟用 Live Stream API，請啟用：

    啟用 API 時所需的角色

    如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    gcloud services enable livestream.googleapis.com

  8. 如果您使用本機殼層，請為使用者帳戶建立本機驗證憑證： 

    gcloud auth application-default login

    如果您使用 Cloud Shell，則不需要執行這項操作。

    如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。

  9. 將角色授予使用者帳戶。針對下列每個 IAM 角色，執行一次下列指令： roles/livestream.editor 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    更改下列內容：

    • PROJECT_ID：專案 ID。
    • USER_IDENTIFIER：使用者帳戶的 ID。 例如：myemail@example.com。
    • ROLE：授予使用者帳戶的 IAM 角色。

  10. 安裝 Google Cloud CLI。

  11. 若您採用的是外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  12. 執行下列指令，初始化 gcloud CLI：

    gcloud init

  13. 建立或選取 Google Cloud 專案。

    選取或建立專案所需的角色

    • 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
    • 建立專案：如要建立專案，您需要專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

    • 建立 Google Cloud 專案：

      gcloud projects create PROJECT_ID

      將 PROJECT_ID 替換為要建立的專案名稱。 Google Cloud

    • 選取您建立的 Google Cloud 專案：

      gcloud config set project PROJECT_ID

      將 PROJECT_ID 替換為 Google Cloud 專案名稱。

  14. 確認 Google Cloud 專案已啟用計費功能。

  15. 如果尚未啟用 Live Stream API，請啟用：

    啟用 API 時所需的角色

    如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    gcloud services enable livestream.googleapis.com

  16. 如果您使用本機殼層，請為使用者帳戶建立本機驗證憑證： 

    gcloud auth application-default login

    如果您使用 Cloud Shell，則不需要執行這項操作。

    如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。

  17. 將角色授予使用者帳戶。針對下列每個 IAM 角色，執行一次下列指令： roles/livestream.editor 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    更改下列內容：

    • PROJECT_ID：專案 ID。
    • USER_IDENTIFIER：使用者帳戶的 ID。 例如：myemail@example.com。
    • ROLE：授予使用者帳戶的 IAM 角色。
    18.

建立 Cloud Storage bucket

建立 Cloud Storage bucket，用來保存直播資訊清單和區隔檔案。

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 點選 「Create」(建立)。
  3. 在「建立 bucket」頁面中，輸入 bucket 資訊。如要前往下一個步驟，請按「繼續」。
    1. 在「開始使用」部分，執行下列操作：
      • 輸入符合bucket 命名規定的全域不重複名稱。
      • 如要新增儲存區標籤，請展開「標籤」部分 ()，按一下 「新增標籤」，然後為標籤指定 key 和 value。
    2. 在「Choose where to store your data」(選擇資料的儲存位置) 專區中，執行下列操作：
      1. 選取「位置類型」。
      2. 從「位置類型」下拉式選單中，選擇要永久儲存 bucket 資料的位置。
        • 如果選取「雙區域」位置類型，您也可以使用相關核取方塊啟用強化型複製。
      3. 如要設定跨值區複製，請選取「新增透過 Storage 移轉服務執行的跨值區複製作業」，然後按照下列步驟操作：

        設定跨 bucket 複製作業

        1. 在「Bucket」選單中選取 bucket。

        2. 在「複製設定」部分，按一下「設定」，設定複製作業。

          「Configure cross-bucket replication」(設定跨 bucket 複製作業) 窗格隨即顯示。

          • 如要依物件名稱前置字串篩選要複製的物件，請輸入要納入或排除物件的前置字串，然後按一下「 新增前置字串」。
          • 如要為複製的物件設定儲存空間級別，請從「儲存空間級別」選單中選取儲存空間級別。如果略過這個步驟，複製的物件預設會使用目標 bucket 的儲存空間級別。
          • 按一下「完成」。
    3. 在「Choose how to store your data」(選擇資料儲存方式) 部分，執行下列操作：
      1. 在「設定預設級別」部分，選取下列選項： 「Standard」。
      2. 如要啟用階層命名空間，請在「Optimize storage for data-intensive workloads」(為資料密集型工作負載提供最理想的儲存空間) 區段中，選取「Enable hierarchical namespace on this bucket」(為這個 bucket 啟用階層命名空間)。
    4. 在「選取如何控制物件的存取權」部分，選取 bucket 是否強制執行禁止公開存取，並為 bucket 的物件選取存取控管方法。
    5. 在「Choose how to protect object data」(選擇保護物件資料的方式) 專區中，執行下列操作：
      • 在「資料保護」下方，選取要為 bucket 設定的選項。
        • 如要啟用虛刪除功能，請勾選「Soft delete policy (For data recovery)」(虛刪除政策 (用於資料復原)) 核取方塊，並指定物件刪除後要保留的天數。
        • 如要設定物件版本管理，請按一下「物件版本管理 (用於版本管控)」核取方塊，並指定每個物件的版本數量上限，以及非現行版本失效的天數。
        • 如要為物件和 bucket 啟用保留政策，請勾選「保留 (符合法規)」核取方塊，然後執行下列操作：
          • 如要啟用物件保留鎖定功能，請勾選「Enable object retention」(啟用物件保留功能) 核取方塊。
          • 如要啟用值區鎖定功能，請勾選「Set bucket retention policy」(設定值區資料保留政策) 核取方塊，然後選擇保留期限的時間單位和長度。
      • 如要選擇物件資料的加密方式，請展開「資料加密」部分 ()，然後選取「資料加密」方法。
  4. 點選「建立」。

指令列

    建立 Cloud Storage bucket： 
    gcloud storage buckets create gs://BUCKET_NAME
     將 BUCKET_NAME 替換為符合bucket 命名規定的 bucket 名稱。

安裝編碼器

如要使用 API，必須要有編碼器產生 API 處理的輸入串流。

請安裝 ffmpeg，因為本頁面說明如何使用 ffmpeg 產生輸入串流。您可以在 Cloud Shell 中使用下列指令安裝。

sudo apt install ffmpeg