amazon-chime-sdk-rails 1.0.0

data/lib/generators/templates/views/meetings/index.html.erb

@@ -0,0 +1,27 @@
+<p id="notice"><%= notice %></p>
+
+<h1>Meetings by Amazon Chime SDK</h1>
+
+<table>
+  <thead>
+    <tr>
+      <th>Meeting ID</th>
+      <th>External Meeting ID</th>
+      <th>Media Region</th>
+      <th colspan="1"></th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <% @meetings.each do |meeting| %>
+      <tr>
+        <td><%= link_to(meeting[:Meeting][:MeetingId], meeting_resource_path(meeting[:Meeting][:MeetingId])) %></td>
+        <td><%= meeting[:Meeting][:ExternalMeetingId] %></td>
+        <td><%= meeting[:Meeting][:MediaRegion] %></td>
+        <td><%= link_to 'Destroy', meeting_resource_path(meeting[:Meeting][:MeetingId]), method: :delete, data: { confirm: 'Are you sure?' } %></td>
+      </tr>
+    <% end %>
+  </tbody>
+</table>
+
+<p><%= link_to 'Create Meeting', meeting_resources_path, method: :post %></p>

data/lib/generators/templates/views/meetings/show.html.erb

@@ -0,0 +1,136 @@
+<p id="notice"><%= notice %></p>
+
+<h1>Meeting by Amazon Chime SDK</h1>
+
+<p><%= link_to("Show Meetings", meeting_resources_path) %></p>
+
+<% if @meeting %>
+  <strong>Meeting</strong>
+  <p>
+    Meeting ID : <%= link_to(@meeting[:Meeting][:MeetingId], meeting_resource_path(@meeting[:Meeting][:MeetingId])) %><br>
+    External Meeting ID : <%= @meeting[:Meeting][:ExternalMeetingId] %><br>
+    Media Region : <%= @meeting[:Meeting][:MediaRegion] %>
+  </p>
+
+  <div id="meeting" meeting-data="<%= @meeting.to_json %>"></div>
+<% end %>
+
+<% if @attendee %>
+  <strong>Attendee</strong>
+  <p>
+    Attendee ID : <%= link_to(@attendee[:Attendee][:AttendeeId], attendee_resource_path(@meeting[:Meeting][:MeetingId], @attendee[:Attendee][:AttendeeId])) %><br>
+    External User ID : <%= @attendee[:Attendee][:ExternalUserId] %><br>
+    Application Attendee Name : <%= application_attendee_name(@attendee) %>
+  </p>
+
+  <div id="status">
+    <strong>Status</strong>
+    <div id="meeting-status">
+      <p>Meeting : Offline <input type="button" value="Join a meeting" onclick="join()"></p>
+    </div>
+    <div id="attendee-status"></div>
+  </div>
+
+  <audio id="audio"></audio>
+
+  <div id="attendee" attendee-data="<%= @attendee.to_json %>"></div>
+  <div id="attendee-resources-path" attendee-resources-path-data="<%= attendee_resources_path(@meeting[:Meeting][:MeetingId]) %>"></div>
+<% end %>
+
+<%= javascript_include_tag "amazon-chime-sdk.min.js" %>
+<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
+
+<script defer>
+  // This is a very simple script as a template view using Amazon Chime SDK.
+  // This script only provides simple audio meeting function.
+  // See the following guide to develop your own video meeting application.
+  // https://github.com/aws/amazon-chime-sdk-js
+  // https://aws.github.io/amazon-chime-sdk-js/modules/gettingstarted.html
+
+  // Customize this function to extract attendee name to show
+  function showApplicationUserName(attendee) {
+    return attendee.Attendee.AttendeeId;
+    // return `${attendee.Attendee.ApplicationMetadata.User.name} (${attendee.Attendee.AttendeeId})`;
+  }
+
+  const meeting = JSON.parse(document.getElementById('meeting').getAttribute('meeting-data'));
+  const attendee = JSON.parse(document.getElementById('attendee').getAttribute('attendee-data'));
+  const attendeeResourcesPath = document.getElementById('attendee-resources-path').getAttribute('attendee-resources-path-data');
+  const audioOutputElement = document.getElementById('audio');
+
+  const logger = new ChimeSDK.ConsoleLogger('ChimeMeetingLogs', ChimeSDK.LogLevel.INFO);
+  const deviceController = new ChimeSDK.DefaultDeviceController(logger);
+  const configuration = new ChimeSDK.MeetingSessionConfiguration(meeting, attendee);
+  const meetingSession = new ChimeSDK.DefaultMeetingSession(configuration, logger, deviceController);
+
+  const attendeeApi = axios.create({
+    baseURL: `${attendeeResourcesPath}/`
+  });
+
+  async function join() {
+    try {
+      const audioInputDevices = await meetingSession.audioVideo.listAudioInputDevices();
+      const audioOutputDevices = await meetingSession.audioVideo.listAudioOutputDevices();
+      await meetingSession.audioVideo.chooseAudioInputDevice(audioInputDevices[0].deviceId);
+      await meetingSession.audioVideo.chooseAudioOutputDevice(audioOutputDevices[0].deviceId);
+    } catch (error) {
+      // handle error - unable to acquire audio device perhaps due to permissions blocking
+      console.log(error);
+    }
+    meetingSession.audioVideo.bindAudioElement(audioOutputElement);
+    meetingSession.audioVideo.start();
+    document.getElementById("meeting-status").innerHTML = '<p>Meeting : Online <input type="button" value="Leave a meeting" onclick="leave()"></p><div id="audio-status"></div>';
+    document.getElementById("audio-status").innerHTML = '<p>Audio : Active <input type="button" value="Mute" onclick="mute()"></p>';
+    document.getElementById("attendee-status").innerHTML = '<strong>Present Attendees</strong>';
+    parepareAttendeeStatus();
+  }
+
+  function leave() {
+    meetingSession.audioVideo.stop();
+    document.getElementById("meeting-status").innerHTML = '<p>Meeting : Offline <input type="button" value="Join a meeting" onclick="join()">';
+    document.getElementById("attendee-status").innerHTML = '';
+  }
+
+  function mute() {
+    meetingSession.audioVideo.realtimeMuteLocalAudio();
+    document.getElementById("audio-status").innerHTML = '<p>Audio : Muted <input type="button" value="Unmute" onclick="unmute()"></p>';
+  }
+
+  function unmute() {
+    const unmuted = meetingSession.audioVideo.realtimeUnmuteLocalAudio();
+    if (unmuted) {
+      document.getElementById("audio-status").innerHTML = '<p>Audio : Active <input type="button" value="Mute" onclick="mute()"></p>';
+    } else {
+      console.log('You cannot unmute yourself');
+    }
+  }
+
+  function parepareAttendeeStatus() {
+    const presentAttendeeMap = {};
+    const callback = (presentAttendeeId, present) => {
+      if (present) {
+        attendeeApi.get(presentAttendeeId)
+          .then(response => {
+            presentAttendeeMap[presentAttendeeId] = response.data;
+            updateAttendeeStatus(presentAttendeeMap);
+          })
+          .catch(error => {
+            console.log(error);
+          });
+      } else {
+        delete presentAttendeeMap[presentAttendeeId]
+        updateAttendeeStatus(presentAttendeeMap);
+      }
+    };
+    meetingSession.audioVideo.realtimeSubscribeToAttendeeIdPresence(callback);
+  }
+
+  function updateAttendeeStatus(presentAttendeeMap) {
+    presentAttendees = "<strong>Present Attendees</strong><ul>";
+    Object.values(presentAttendeeMap).forEach(attendee => {
+      presentAttendees = presentAttendees + `<li>${showApplicationUserName(attendee)}</li>`
+    });
+    presentAttendees = presentAttendees + '</ul>'
+    document.getElementById("attendee-status").innerHTML = presentAttendees;
+  }
+</script>

data/spec/factories/rooms.rb

@@ -0,0 +1,5 @@
+FactoryBot.define do
+  factory :room do
+    name { "DefaultRoom" }
+  end
+end

data/spec/factories/users.rb

@@ -0,0 +1,8 @@
+FactoryBot.define do
+  factory :user do
+    name { Array.new(10){[*"A".."Z", *"0".."9"].sample}.join }
+    email { name + '@example.com' }
+    password { "password" }
+    password_confirmation { "password" }
+  end
+end

data/spec/generators/controllers_generator_spec.rb

@@ -0,0 +1,113 @@
+require 'generators/chime_sdk/controllers_generator'
+
+describe ChimeSdk::Generators::ControllersGenerator, type: :generator do
+  destination File.expand_path("../../../tmp", __FILE__)
+  before { prepare_destination }
+
+  it 'runs generating controllers tasks' do
+    gen = generator
+    expect(gen).to receive :generate_controllers
+    expect(gen).to receive(:readme).and_return(true)
+    gen.invoke_all
+  end
+
+  describe 'generating files' do
+    context 'without prefix argument' do
+      before do
+        run_generator
+      end
+
+      describe 'app/controllers/meetings_controller' do
+        subject { file('app/controllers/meetings_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class MeetingsController < ApplicationController/) }
+        it { is_expected.to contain(" meetings_path(params)\n") }
+      end
+
+      describe 'app/controllers/meeting_attendees_controller' do
+        subject { file('app/controllers/meeting_attendees_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class MeetingAttendeesController < ApplicationController/) }
+        it { is_expected.to contain(" meetings_path(params)\n") }
+      end
+    end
+
+    context 'with room as prefix' do
+      before do
+        run_generator %w(room)
+      end
+
+      describe 'app/controllers/room_meetings_controller' do
+        subject { file('app/controllers/room_meetings_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class RoomMeetingsController < ApplicationController/) }
+        it { is_expected.to contain(" room_meetings_path(@room, params)\n") }
+      end
+
+      describe 'app/controllers/room_meeting_attendees_controller' do
+        subject { file('app/controllers/room_meeting_attendees_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class RoomMeetingAttendeesController < ApplicationController/) }
+        it { is_expected.to contain(" room_meetings_path(@room, params)\n") }
+      end
+    end
+
+    context 'with room as --parent option' do
+      before do
+        run_generator %w(--parent room)
+      end
+
+      describe 'app/controllers/meetings_controller' do
+        subject { file('app/controllers/meetings_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class MeetingsController < ApplicationController/) }
+        it { is_expected.to contain(" room_meetings_path(@room, params)\n") }
+      end
+
+      describe 'app/controllers/meeting_attendees_controller' do
+        subject { file('app/controllers/meeting_attendees_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class MeetingAttendeesController < ApplicationController/) }
+        it { is_expected.to contain(" room_meetings_path(@room, params)\n") }
+      end
+    end
+
+    context 'with api as --namespace option' do
+      before do
+        run_generator %w(--namespace api)
+      end
+
+      describe 'app/controllers/api/meetings_controller' do
+        subject { file('app/controllers/api/meetings_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class Api::MeetingsController < ApplicationController/) }
+        it { is_expected.to contain(" api_meetings_path(params)\n") }
+      end
+
+      describe 'app/controllers/api/meeting_attendees_controller' do
+        subject { file('app/controllers/api/meeting_attendees_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class Api::MeetingAttendeesController < ApplicationController/) }
+        it { is_expected.to contain(" api_meetings_path(params)\n") }
+      end
+    end
+
+    context 'with meetings as --controllers option' do
+      before do
+        run_generator %w(--controllers meetings)
+      end
+
+      describe 'app/controllers/meetings_controller' do
+        subject { file('app/controllers/meetings_controller.rb') }
+        it { is_expected.to exist }
+        it { is_expected.to contain(/class MeetingsController < ApplicationController/) }
+        it { is_expected.to contain(" meetings_path(params)\n") }
+      end
+
+      describe 'app/controllers/meeting_attendees_controller' do
+        subject { file('app/controllers/meeting_attendees_controller.rb') }
+        it { is_expected.not_to exist }
+      end
+    end
+  end
+end

data/spec/generators/install_generator_spec.rb

@@ -0,0 +1,24 @@
+require 'generators/chime_sdk/install_generator'
+
+describe ChimeSdk::Generators::InstallGenerator, type: :generator do
+  destination File.expand_path("../../../tmp", __FILE__)
+  before { prepare_destination }
+
+  it 'runs generating initializer task' do
+    gen = generator
+    expect(gen).to receive :copy_initializer
+    gen.invoke_all
+  end
+
+  describe 'generating files' do
+    before do
+      run_generator
+    end
+
+    describe 'config/initializers/chime_sdk.rb as an initializer' do
+      subject { file('config/initializers/chime_sdk.rb') }
+      it { is_expected.to exist }
+      it { is_expected.to contain(/ChimeSdk.configure do |config|/) }
+    end
+  end
+end

data/spec/generators/js_generator_spec.rb

@@ -0,0 +1,26 @@
+require 'generators/chime_sdk/js_generator'
+
+describe ChimeSdk::Generators::JsGenerator, type: :generator do
+  destination File.expand_path("../../../tmp", __FILE__)
+  before { prepare_destination }
+
+  it 'runs generating Amazon Chime SDK single .js file task' do
+    gen = generator
+    expect(gen).to receive :build_and_copy_chime_sdk_js
+    gen.invoke_all
+  end
+
+  describe 'generating files' do
+    context 'when npm is installed' do
+      before do
+        run_generator
+      end
+
+      # This test takes a long time. Skip it by xdescribe if you are developing the gem.
+      describe 'app/assets/javascripts/amazon-chime-sdk.min.js' do
+        subject { file('app/assets/javascripts/amazon-chime-sdk.min.js') }
+        it { is_expected.to exist }
+      end
+    end
+  end
+end

data/spec/generators/views_generator_spec.rb

@@ -0,0 +1,46 @@
+require 'generators/chime_sdk/views_generator'
+
+describe ChimeSdk::Generators::ViewsGenerator, type: :generator do
+  destination File.expand_path("../../../tmp", __FILE__)
+  before { prepare_destination }
+
+  it 'runs generating views tasks' do
+    gen = generator
+    expect(gen).to receive :generate_views
+    gen.invoke_all
+  end
+
+  describe 'generating files' do
+    context 'without prefix argument' do
+      before do
+        run_generator
+      end
+
+      describe 'app/views/meetings/index.html.erb' do
+        subject { file('app/views/meetings/index.html.erb') }
+        it { is_expected.to exist }
+      end
+
+      describe 'app/views/meetings/show.html.erb' do
+        subject { file('app/views/meetings/show.html.erb') }
+        it { is_expected.to exist }
+      end
+    end
+
+    context 'with room as prefix argument' do
+      before do
+        run_generator %w(room)
+      end
+
+      describe 'rapp/views/oom_meetings/index.html.erb' do
+        subject { file('app/views/room_meetings/index.html.erb') }
+        it { is_expected.to exist }
+      end
+
+      describe 'app/views/room_meetings/show.html.erb' do
+        subject { file('app/views/room_meetings/show.html.erb') }
+        it { is_expected.to exist }
+      end
+    end
+  end
+end

data/spec/rails_app/Rakefile

@@ -0,0 +1,15 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require_relative 'config/application'
+
+Rails.application.load_tasks
+
+# Define dummy module for Rake tasks
+require 'devise_token_auth'
+unless defined?(DeviseTokenAuth::Concerns::User)
+  module DeviseTokenAuth::Concerns
+    module User
+    end
+  end
+end

data/spec/rails_app/app/assets/config/manifest.js

@@ -0,0 +1,2 @@
+//= link_tree ../images
+//= link_directory ../stylesheets .css

data/spec/rails_app/app/assets/stylesheets/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, or any plugin's
+ * vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/spec/rails_app/app/assets/stylesheets/scaffolds.scss

@@ -0,0 +1,65 @@
+body {
+  background-color: #fff;
+  color: #333;
+  margin: 33px; }
+
+body, p, ol, ul, td {
+  font-family: verdana, arial, helvetica, sans-serif;
+  font-size: 13px;
+  line-height: 18px; }
+
+pre {
+  background-color: #eee;
+  padding: 10px;
+  font-size: 11px; }
+
+a {
+  color: #000; }
+
+a:visited {
+  color: #666; }
+
+a:hover {
+  color: #fff;
+  background-color: #000; }
+
+th {
+  padding-bottom: 5px; }
+
+td {
+  padding: 0 5px 7px; }
+
+div.field,
+div.actions {
+  margin-bottom: 10px; }
+
+#notice {
+  color: green; }
+
+.field_with_errors {
+  padding: 2px;
+  background-color: red;
+  display: table; }
+
+#error_explanation {
+  width: 450px;
+  border: 2px solid red;
+  padding: 7px 7px 0;
+  margin-bottom: 20px;
+  background-color: #f0f0f0; }
+
+#error_explanation h2 {
+  text-align: left;
+  font-weight: bold;
+  padding: 5px 5px 5px 15px;
+  font-size: 12px;
+  margin: -7px -7px 0;
+  background-color: #c00;
+  color: #fff; }
+
+#error_explanation ul li {
+  font-size: 12px;
+  list-style: square; }
+
+label {
+  display: block; }